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:
- Ketahui apakah pengguna mengalami error.
- Lihat seberapa sering error terjadi, dan mana yang paling sering.
- 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 Membuat project Cloud dan mengaktifkan API.
- Publikasikan add-on di Google Workspace Marketplace. Untuk memublikasikan add-on di Marketplace, lihat Memublikasikan aplikasi.
Log error add-on kueri
Untuk mendapatkan log add-on:
- Buka konsol Google Cloud.
- Di samping "Google Cloud Platform," klik Panah bawah , lalu pilih project add-on.
- Di pojok 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 Jalankan kueri. Atau, untuk melihat error yang terjadi, klik Streaming log. Log error add-on muncul di panel "Query results".
Untuk mengetahui informasi lebih lanjut tentang Cloud Logs Explorer dan penulisan kueri, lihat artikel berikut:
Mengaktifkan atau menonaktifkan logging error
Secara default, logging error diaktifkan. Saat logging error diaktifkan, file manifes 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 bekerja dengan 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 menimbulkan biaya. Untuk mengetahui informasi lebih lanjut tentang harga Cloud Logging, lihat harga Google Cloud Operations Suite.