Saat Add-on Google Workspace yang dipublikasikan menampilkan error, antarmuka {i>add-on<i} mengembalikan pesan generik "Terjadi error saat menjalankan add-on." Namun, kesalahan ini yang dicatat ke Cloud Logs Explorer.
Panduan ini menjelaskan cara mengkueri log error add-on dalam Cloud Logs Explorer, sehingga Anda dapat:
- Pelajari apakah pengguna mengalami error.
- Lihat seberapa sering error terjadi, dan mana yang paling sering terjadi.
- Membaca pesan error deskriptif yang membantu Anda memperbaikinya.
Prasyarat
Sebelum membuat kueri log error add-on:
- Mengaktifkan "Cloud Logging API" di add-on project Google Cloud Anda. Untuk mengaktifkan API, lihat Buat project Cloud dan aktifkan API.
- Publikasikan add-on di Google Workspace Marketplace. Untuk memublikasikan add-on di Marketplace, lihat Publikasikan 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 add-on project.
- Di sudut kiri atas, klik Menu > Logging. Logs Explorer akan terbuka.
Untuk log error add-on, pada builder kueri, masukkan kueri berikut:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"Untuk melihat error terbaru, klik Jalankan kueri. Atau, untuk melihat {i>error<i} pada terjadi, klik Stream logs. Log kesalahan add-on muncul di "Query results" (Hasil kueri) Google Analytics.
Untuk mengetahui informasi lebih lanjut tentang Cloud Logs Explorer dan penulisan kueri, lihat hal 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 di kolom
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 Penjelajah, perhatikan pertimbangan berikut:
- Add-on hanya mencatat error di Logs Explorer. Jenis log lainnya adalah tidak dicatat.
- Pesan error selalu ditulis dalam bahasa Inggris.
- Cloud Logging akan dikenai biaya. Untuk mengetahui informasi lebih lanjut tentang Cloud Logging harga, lihat harga Google Cloud Observability.