Ringkasan Error Reporting

Error Reporting menggabungkan error yang terjadi di layanan cloud yang sedang berjalan. Error ini dilaporkan oleh Error Reporting API atau disimpulkan sebagai error saat Error Reporting memeriksa entri log untuk pola teks umum seperti stack trace. Error Reporting mengelompokkan error yang dianggap memiliki penyebab utama yang sama.

Error Reporting diaktifkan secara otomatis.

Error Reporting mengambil sampel hingga 1.000 error per jam. Jika batas ini tercapai, jumlah yang ditampilkan diperkirakan. Jika terlalu banyak peristiwa 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 dibangun di atas 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. Error Reporting tidak dapat menyimpan entri log di bucket log yang mengaktifkan CMEK. 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 dalam project yang sama dengan tempat asal entri log.
    • Entri log diarahkan ke project, lalu project tersebut menyimpan entri log tersebut dalam bucket log yang dimilikinya.

Cara pengelompokan error

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

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

Selanjutnya, Error Reporting mengikuti aturan berikut untuk mengelompokkan error:

  • Pengecualian dikelompokkan jika memiliki jenis pengecualian yang sama dan stack yang serupa.
  • Stack trace diabaikan untuk pengecualian yang biasanya tidak terkait dengan lokasi sumber tempat terjadinya.
  • Error tanpa stack pengecualian dikelompokkan bersama jika dibuat oleh entri log yang sama, yang diperkirakan oleh lokasi sumber tempat error dilaporkan dari (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 stack trace. Dalam kasus pengecualian bertingkat, pengecualian paling dalam yang 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 dari pesan yang dipertimbangkan. Dalam contoh di sebelah kiri, nilai ini adalah runtime, error, dan index.

Regionalitas data

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

Di Cloud Logging, Anda dapat meregionalkan log 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 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 Wilayah. Menu ini memiliki nilai default global.

Menu Region di halaman Error Groups.

Langkah berikutnya