Saat Add-on Google Workspace yang dipublikasikan menampilkan error, antarmuka add-on akan menampilkan pesan umum "Terjadi masalah 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 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.
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 Stream logs. Log error add-on akan muncul di panel "Query results".
Untuk mengetahui informasi lebih lanjut tentang Cloud Logs Explorer dan cara menulis kueri, lihat berikut ini:
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 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 menimbulkan biaya. Untuk mengetahui informasi selengkapnya tentang harga Cloud Logging, lihat harga Google Cloud Observability.