Error Reporting menggabungkan dan mengelompokkan peristiwa error aplikasi berdasarkan akar penyebabnya, sehingga membantu Anda mengidentifikasi, memprioritaskan, dan menyeleksi masalah di seluruh layanan cloud. Peristiwa error mewakili satu kejadian error aplikasi dan mencatat stempel waktu, konteks eksekusi, dan pesan error.
Error Reporting diaktifkan secara otomatis dan mulai mendeteksi error tanpa memerlukan penyiapan manual. Layanan ini mengumpulkan peristiwa error langsung dari Error Reporting API atau menyimpulkan nya dengan memindai entri log untuk pelacakan tumpukan dan pola error umum.
Untuk mengoptimalkan performa, Error Reporting mengambil sampel hingga 1.000 error per jam, dan memperkirakan jumlahnya saat mencapai nilai minimum ini. Jika volume peristiwa melebihi kapasitas, Error Reporting akan mengambil sampel hingga 100 error per jam dan terus mengekstrapolasi jumlah yang ditampilkan.
Saat Error Reporting menganalisis entri log
Error Reporting adalah layanan global yang dibangun di 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 di project yang sama dengan tempat asal entri log.
- Entri log dirutekan ke project, lalu project tersebut menyimpan entri log tersebut di bucket log yang dimilikinya.
Cara pengelompokan peristiwa error
Saat Error Reporting mengevaluasi entri log untuk mengidentifikasi peristiwa error, layanan ini akan mengabaikan data berikut:
- Entri log yang ditulis oleh lingkungan standar App Engine yang memiliki tingkat keparahan lebih rendah dari
ERROR. - Frame tumpukan yang bukan milik pengguna, seperti frame yang termasuk dalam library publik.
Saat entri log dipindai, Error Reporting akan melakukan perubahan berikut sebelum menyimpulkan peristiwa error:
- Mengganti urutan berulang dari satu atau beberapa frame tumpukan dengan satu kejadian 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 untuk App Engine: com.google.apphosting.runtime.HardDeadlineExceededError com.google.appengine.api.datastore.DatastoreTimeoutException Masalah Java: java.util.concurrent.CancellationException |
Dikelompokkan berdasarkan jenis pengecualian. |
| Peristiwa error dengan pelacakan tumpukan. Dalam kasus pengecualian bertingkat
pengecualian terdalam akan dipertimbangkan.
Contoh: runtime error: index out of range
package1.func1()
file1:20
package2.func2()
file2:33 |
Dikelompokkan berdasarkan jenis pengecualian dan lima frame teratas. |
| Peristiwa error tanpa pelacakan tumpukan, tetapi dengan pesan.
Contoh: runtime error: index out of range
func1()Dalam contoh ini, token berikut akan dipertimbangkan:
|
Dikelompokkan berdasarkan pesan dan (jika ada) nama fungsi. Hanya tiga token literal pertama dari pesan yang dipertimbangkan. |
Regionalitas data
Jika Anda menyiapkan Assured Workloads untuk persyaratan residensi data atau Tingkat Dampak 4 (IL4) maka Google Cloud akan otomatis menonaktifkan Error Reporting.
Di Cloud Logging, Anda dapat meregionalkan log dengan merutekan
nya 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-central1 hanya berisi log error yang merupakan bagian dari bucket log di us-central1. Grup error global hanya berisi log error yang merupakan bagian dari bucket log di region global.
Untuk memfilter region grup error yang ditampilkan di halaman Grup Error , pilih nilai dari menu Region. Menu ini memiliki nilai default global.
