Ringkasan Error Reporting

Error Reporting menggabungkan error yang dihasilkan dalam layanan cloud yang sedang berjalan. Error ini dilaporkan oleh Error Reporting API atau disimpulkan sebagai error saat Pelaporan Error memeriksa entri log untuk pola teks umum seperti pelacakan tumpukan. Pelaporan Error mengelompokkan error yang dianggap memiliki akar masalah yang sama.

Pelaporan Error diaktifkan secara otomatis.

Error Reporting mengambil sampel hingga 1.000 error per jam. Jika batas ini tercapai, jumlah yang ditampilkan akan diperkirakan. Jika terlalu banyak peristiwa yang diterima, Error Reporting akan mengambil sampel hingga 100 error per jam dan terus mengekstrapolasi jumlahnya.

Saat Error Reporting menganalisis entri log

Error Reporting adalah layanan global yang dibuat di Cloud Logging dan dapat menganalisis entri log jika semua hal berikut terpenuhi:

  • Assured workloads dinonaktifkan. Untuk mengetahui informasi selengkapnya, lihat Ringkasan Assured Workloads.
  • Kunci enkripsi yang dikelola pelanggan (CMEK) dinonaktifkan di semua bucket log yang menyimpan entri log. Untuk mengetahui informasi tentang cara menentukan konfigurasi CMEK untuk bucket log, lihat Memverifikasi pengaktifan kunci.
  • Bucket log memenuhi salah satu hal berikut:
    • Bucket log disimpan di project yang sama dengan tempat entri log berasal.
    • Entri log dirutekan ke project, lalu project tersebut menyimpan entri log tersebut dalam bucket log yang dimilikinya.
Jika menyimpan entri log di bucket log dengan CMEK diaktifkan, Anda masih dapat menggunakan Pelaporan Error. Namun, Anda harus menggunakan library klien Error Reporting atau Error Reporting API. Untuk informasi selengkapnya, lihat ringkasan Error Reporting API dan library klien Error Reporting.

Cara error dikelompokkan

Saat mengevaluasi entri log, Pelaporan Error akan mengabaikan entri log dengan kondisi berikut:

  • Di lingkungan standar App Engine, error yang dicatat ke dalam log dengan tingkat keparahan lebih rendah dari ERROR akan diabaikan.
  • Frame stack yang tidak dimiliki oleh pengguna akan diabaikan (misalnya, yang milik library publik).
  • Setiap urutan berulang dari satu atau beberapa frame stack diganti dengan satu kejadian urutan tersebut.
  • Metode dan simbol yang diperkenalkan compiler dihapus.

Selanjutnya, Pelaporan Error mengikuti aturan berikut untuk mengelompokkan error:

  • Pengecualian dikelompokkan bersama jika memiliki jenis pengecualian yang sama dan stack yang serupa.
  • Stack trace diabaikan untuk pengecualian yang biasanya tidak terkait dengan lokasi sumber tempat pengecualian tersebut terjadi.
  • Error tanpa stack pengecualian dikelompokkan bersama jika dibuat oleh entri log yang sama, yang diperkirakan oleh lokasi sumber tempat error tersebut dilaporkan (reportLocation).

Secara khusus, aturan pengelompokan berikut diterapkan dalam urutan ini:

Jenis error Dikelompokkan berdasarkan
Error yang disebabkan oleh masalah umum di lingkungan.

Misalnya, masalah khusus App Engine:

com.google.apphosting.runtime.HardDeadlineExceededError
 
com.google.appengine.api.datastore.DatastoreTimeoutException

Masalah Java:

java.util.concurrent.CancellationException
 Dikelompokkan menurut jenis pengecualian.
Error dengan pelacakan tumpukan. Dalam kasus pengecualian bertingkat, pengecualian paling dalam akan dipertimbangkan.

Contoh:

runtime error: index out of range
package1.func1()
      file1:20
package2.func2()
      file2:33
 Dikelompokkan menurut jenis pengecualian dan 5 frame teratas.
Error tanpa pelacakan tumpukan, tetapi dengan pesan.

Contoh:

runtime error: index out of range
    func1()
 Dikelompokkan menurut pesan dan (jika ada) nama fungsi. Hanya 3 token literal pertama pesan yang dipertimbangkan. Pada contoh di sebelah kiri, nilai ini adalah runtime, error, dan index.

Regionalitas data

Jika Anda menyiapkan Assured Workloads untuk persyaratan residensi data atau Impact Level 4 (IL4), Google Cloud akan otomatis menonaktifkan Pelaporan Error.

Di Cloud Logging, Anda dapat membuat log secara regional dengan merutekannya ke lokasi tertentu. Di halaman Grup Error, Error Reporting mengatur dan menampilkan grup error berdasarkan region bucket log yang berisi entri log. Misalnya, grup error yang tercantum di bagian us-central-1 hanya berisi log error yang merupakan bagian dari bucket log di us-central-1. Grup error global hanya berisi log error yang merupakan bagian dari bucket log di region global.

Untuk memfilter wilayah grup error yang ditampilkan di halaman Grup Error, pilih nilai dari menu Region. Menu ini memiliki nilai default global.

Menu Region di halaman Error Groups.

Langkah selanjutnya