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 dalam 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 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 terbuka.
Untuk log error add-on, di pembuat 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 informasi lebih lanjut tentang Cloud Logs Explorer dan penulisan 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 bekerja dengan log error add-on di Penjelajah Cloud Logs, 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 informasi harga Cloud Logging lebih lanjut, lihat harga Google Cloud Operations Suite.