Error Reporting menggabungkan peristiwa error yang terjadi di layanan cloud yang sedang berjalan. Peristiwa error mewakili satu kejadian error di aplikasi Anda. Data yang disimpan untuk setiap peristiwa mencakup informasi tentang error, seperti waktu terjadinya, konteks terjadinya, dan pesan error yang ditampilkan.
Peristiwa error dilaporkan oleh Error Reporting API atau disimpulkan oleh Error Reporting saat memeriksa entri log untuk pola teks umum seperti stack trace. Error Reporting mengelompokkan peristiwa 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 benar:
- 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 entri log berasal.
- Entri log diarahkan ke project, lalu project tersebut menyimpan entri log tersebut dalam bucket log yang dimilikinya.
Cara peristiwa error dikelompokkan
Saat mengevaluasi entri log untuk mengidentifikasi peristiwa error, Error Reporting mengabaikan entri log dengan kondisi berikut:
- Entri log yang ditulis oleh lingkungan standar App Engine yang memiliki tingkat keparahan lebih rendah dari
ERROR. - Frame stack yang bukan milik pengguna (misalnya, yang milik library publik).
Saat entri log dipindai, Error Reporting melakukan modifikasi berikut sebelum menyimpulkan peristiwa error:
- Mengganti urutan berulang dari satu atau beberapa frame stack dengan satu kemunculan urutan tersebut.
- Menghapus metode dan simbol yang diperkenalkan oleh compiler.
Error Reporting menerapkan aturan ini, dalam urutan yang ditentukan, untuk mengelompokkan peristiwa error:
| Peristiwa Error | Dikelompokkan berdasarkan |
|---|---|
| Peristiwa 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. |
| Peristiwa 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. |
| Peristiwa 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. Pada 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.
