Log error kueri untuk add-on Google Workspace

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.

Catatan: Untuk Apps Script, jika add-on Anda di-deploy sebagai pengujian, error akan dilaporkan di Cloud Logs Explorer dan di antarmuka add-on.

Misalnya, deployment pengujian add-on mungkin menampilkan pesan error seperti ini di antarmukanya: TypeError: card.INVALIDFUNCTIONNAME is not a function [line: 33, function: getContextualAddOn, file: GetContextualAddOn].

Meskipun pesan error seperti ini bermanfaat, informasi tambahan tersedia di Logs Explorer. Sebagai praktik terbaik, buat kueri log error untuk mengetahui informasi selengkapnya. Untuk informasi lebih lanjut tentang pengujian deployment add-on, lihat Menguji dan men-debug add-on Google Workspace.

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:

1. Buka Konsol Google Cloud.
2. Di samping "Google Cloud Platform", klik Panah bawah , lalu pilih project add-on.
3. Di sudut kiri atas, klik Menu > Logging. Logs Explorer akan terbuka.

4. Untuk log error add-on, di builder kueri, masukkan kueri berikut:

   severity>=ERROR
   protoPayload.serviceName="gsuiteaddons.googleapis.com"
   

5. 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:

• Menggunakan Logs Explorer
• Mem-build kueri

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.