Panduan ini menjelaskan cara membuat kueri log error aplikasi Chat di Google Cloud Logs Explorer. Log kueri untuk:
- Pelajari apakah pengguna mengalami error.
- Lihat seberapa sering error terjadi, dan mana yang paling sering terjadi.
- Membaca pesan error deskriptif dan data log yang membantu Anda memperbaiki error.
Prasyarat
- Akun Google Workspace dengan akses ke Google Chat.
- Aplikasi Chat. Untuk membuat aplikasi Chat, ikuti panduan memulai ini.
- Aktifkan logging error untuk aplikasi Chat.
Log error kueri
Di Konsol Google Cloud, klik Menu > Produk lainnya > Logging > Logs Explorer.
Jika perlu, untuk menampilkan pembuat kueri, aktifkan Tampilkan kueri.
Untuk log error aplikasi Chat, masukkan kueri berikut:
severity=ERROR resource.type="chat.googleapis.com/Project"
Untuk melihat error terbaru, klik Jalankan kueri. Atau, untuk melihat error yang terjadi, klik Streaming log. Log error aplikasi Chat muncul di "Query results" Google Analytics.
Untuk mempelajari Google Cloud Logs Explorer lebih lanjut dan cara menulis kueri, lihat panduan ini dalam dokumentasi Logs Explorer:
Membaca pesan error dari log
Setelah membuat kueri log error, Anda dapat melihat log individual yang terdiri dari payload JSON yang mendeskripsikan log. Untuk error aplikasi Chat, JSON akan menyertakan pesan error di jsonPayload.error.message
. Misalnya, dalam contoh log berikut, pesan error menyatakan bahwa fungsi Apps Script gagal dijalankan:
JSON
{
"insertId": "INSERT_ID",
"jsonPayload": {
"@type": "type.googleapis.com/google.chat.logging.v1.ChatAppLogEntry",
"error": {
"code": 9,
"message": "An Apps Script function failed to execute. To review AppsScript error logs, see \"Logging\" (https://developers.google.com/apps-script/guides/logging)."
},
"deployment": "DEPLOYMENT_ID"
},
"resource": {
"type": "chat.googleapis.com/Project",
"labels": {
"project_id": "PROJECT_ID"
}
},
"timestamp": "2022-12-06T05:24:18.697255Z",
"severity": "ERROR",
"logName": "projects/PROJECT_ID/logs/chat.googleapis.com%2Ferrors",
"receiveTimestamp": "2022-12-06T05:24:19.207936968Z"
}
Pertimbangan
Saat Anda bekerja dengan log error aplikasi Chat di Google Cloud Logs Explorer, perhatikan pertimbangan berikut:
Untuk aplikasi Google Chat, Logs Explorer saat ini menyertakan log dengan tingkat keparahan berikut yang membantu memecahkan masalah aplikasi yang tidak berfungsi:
ERROR
Log layanan terkait juga dapat membantu men-debug aplikasi Chat. Misalnya, jika aplikasi Chat di-deploy menggunakan Google Cloud Functions, sebaiknya periksa juga log Logs Explorer untuk Cloud Functions.
Pesan error selalu ditulis dalam bahasa Inggris.
Cloud Logging akan dikenai biaya. Untuk informasi lebih lanjut tentang harga Cloud Logging, lihat harga Google Cloud Operations Suite.
Topik terkait
Setelah mengkueri log error, jika Anda menemukan error, lihat panduan berikut untuk bantuan dalam memperbaiki error:
- Pelajari cara memperbaiki error aplikasi Google Chat seperti "Aplikasi tidak merespons", "Google Chat API hanya tersedia untuk pengguna Google Workspace", atau "Pengguna dapat dikecualikan dari ruang".
- Pelajari cara memperbaiki error kartu seperti pesan kartu, dialog, atau pratinjau link yang tidak dirender atau berfungsi seperti yang diharapkan.
- Pelajari cara men-debug.