Kumpulkan data error menggunakan Error Reporting

Dokumen ini mencantumkan lingkungan yang didukung oleh Error Reporting dan tertaut ke panduan khusus bahasa untuk developer aplikasi. Sebaiknya gunakan library klien untuk bahasa tertentu atau andalkan log yang dikumpulkan secara otomatis. Namun, Anda dapat menulis data error dengan Cloud Logging API atau Error Reporting API. Misalnya, jika Anda menggunakan Cloud Run, pengecualian yang ditulis ke stderr akan otomatis dikirim ke Cloud Logging.

Error Reporting adalah layanan global yang secara otomatis menganalisis log di project Google Cloud untuk mengidentifikasi error. Namun, Error Reporting hanya dapat menganalisis entri log yang disimpan di bucket Cloud Logging yang berada di region global, dengan project Google Cloud sumber dan tujuannya sama, serta kunci enkripsi yang dikelola pelanggan (CMEK) dinonaktifkan. Jika Anda mengarahkan log ke project Google Cloud lain, bucket regional, atau mengaktifkan CMEK, Error Reporting tidak akan menangkap dan menganalisis log tersebut. Untuk mengetahui informasi tentang cara memverifikasi konfigurasi bucket log Anda, lihat Pemecahan masalah.

Dukungan Virtual Private Cloud

Error Reporting adalah layanan yang didukung Virtual Private Cloud (VPC).

Untuk mengurangi risiko pemindahan data yang tidak sah, gunakan Kontrol Layanan VPC untuk membuat perimeter layanan di sekeliling layanan yang dikelola Google. Untuk mendapatkan informasi tentang Kontrol Layanan VPC dan cara membuat parameter layanan, lihat dokumentasi Kontrol Layanan VPC.

Mengonfigurasi lingkungan untuk melaporkan data error secara otomatis

Untuk mengetahui informasi tentang persyaratan konfigurasi khusus lingkungan, lihat panduan berikut:

• Lingkungan fleksibel App Engine
• Lingkungan standar App Engine
• Apps Script
• Cloud Functions
• Cloud Run
• Compute Engine
• Google Kubernetes Engine
• Amazon EC2

Melengkapi aplikasi dengan menggunakan library klien

Untuk mendapatkan informasi tentang cara mengonfigurasi aplikasi Anda agar mengirim laporan error, lihat panduan konfigurasi spesifik per bahasa:

• Aplikasi Go
• Aplikasi Java
• Aplikasi.NET
• Aplikasi Node.js
• Aplikasi Python
• Aplikasi PHP
• Aplikasi Ruby

Menulis data error menggunakan API

Anda dapat melaporkan peristiwa error ke project Google Cloud dengan menjalankan metode Error Reporting API report atau metode Cloud Logging API write.

• Jika Anda memerlukan autentikasi berbasis kunci API, Anda harus menggunakan Error Reporting API. Untuk melaporkan peristiwa error menggunakan Error Reporting API, jalankan metode report dan format isi permintaan metode sebagai objek ReportedErrorEvent.

  Saat Anda menggunakan Error Reporting API, entri log dengan pesan error yang diformat dengan benar akan otomatis dibuat dan ditulis ke Cloud Logging. Entri log ini ditulis ke log yang logName-nya diformat sebagai berikut:

  projects/PROJECT_ID/clouderrorreporting.googleapis.com%2Freported_errors
  

  Karena entri log dibuat oleh panggilan ke report, Anda mungkin dikenai biaya penyerapan Cloud Logging. Untuk mengontrol log yang diserap, lihat Filter pengecualian.

  Jika Anda melaporkan peristiwa error menggunakan Error Reporting API, bagian lain dari dokumen ini tidak akan berlaku.

• Jika ingin menggunakan Cloud Logging API, Anda harus memformat objek LogEntry sehingga menyertakan pelacakan tumpukan, atau objek ReportedErrorEvent. Untuk informasi selengkapnya tentang persyaratan pemformatan, lihat Error format dalam log.