Saat add-on Google Workspace yang dipublikasikan menampilkan error, antarmuka add-on akan menampilkan pesan umum "Terjadi error saat menjalankan add-on". Namun, error ini dicatat ke Cloud Logs Explorer.
Panduan ini menjelaskan cara membuat kueri log error add-on di Cloud Logs Explorer, sehingga Anda dapat:
- Pelajari apakah pengguna mengalami error.
- Lihat seberapa sering error terjadi, dan error mana yang paling sering terjadi.
- Baca pesan error deskriptif yang membantu Anda memperbaikinya.
Prasyarat
Sebelum membuat kueri log error add-on:
- Aktifkan "Cloud Logging API" di project Google Cloud add-on. Untuk mengaktifkan API, lihat artikel Membuat project Cloud dan mengaktifkan API.
- Publikasikan add-on di Google Workspace Marketplace. Untuk memublikasikan add-on di Marketplace, lihat Memublikasikan aplikasi.
Mengkueri log error add-on
Untuk mendapatkan log add-on:
- Buka Konsol Google Cloud.
- Di samping "Google Cloud Platform", klik Panah bawah , lalu pilih project add-on.
- Di sudut kiri atas, klik Menu > Logging. Logs Explorer akan terbuka.
Untuk log error add-on, di builder kueri, masukkan kueri berikut:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"Untuk melihat error terbaru, klik Run query. Atau, untuk melihat error saat terjadi, klik Log streaming. Log error add-on muncul di panel "Hasil kueri".
Untuk informasi lebih lanjut tentang Cloud Logs Explorer dan cara menulis kueri, lihat referensi berikut:
Mengaktifkan atau menonaktifkan logging error
Secara default, logging error diaktifkan. Jika logging error diaktifkan, file manifes akan memiliki hal berikut:
"exceptionLogging": "STACKDRIVER",
Untuk menonaktifkan logging error, ganti
"exceptionLogging": "STACKDRIVER", dengan baris berikut dalam
file manifes:
// Disable error logging
"exceptionLogging": "NONE"
Untuk mengaktifkan kembali logging error, ganti "exceptionLogging": "NONE" dengan
"exceptionLogging": "STACKDRIVER",.
Pertimbangan
Saat Anda menggunakan log error add-on di Cloud Logs Explorer, perhatikan pertimbangan berikut:
- Add-on hanya mencatat error di Logs Explorer. Jenis log lainnya tidak dicatat.
- Pesan error selalu ditulis dalam bahasa Inggris.
- Cloud Logging dikenai biaya. Untuk informasi lebih lanjut tentang harga Cloud Logging, lihat harga Google Cloud Observability.