Yayınlanan bir Google Workspace eklentisi hata verdiğinde eklenti arayüzü, "Eklenti çalıştırılırken bir sorun oluştu." şeklinde genel bir mesaj döndürür. Ancak bu hatalar Cloud Günlük Gezgini'ne kaydedilir.
Bu kılavuzda, Cloud Günlük Gezgini'nde eklenti hata günlüklerinin nasıl sorgulanacağı açıklanmaktadır. Böylece şunları yapabilirsiniz:
- Kullanıcıların hatalarla karşılaşıp karşılaşmadığını öğrenin.
- Hataların ne sıklıkla ve hangilerinin en sık oluştuğunu görün.
- Bu sorunları düzeltmenize yardımcı olan açıklayıcı hata mesajlarını okuyun.
Ön koşullar
Eklenti hata günlüklerini sorgulamadan önce:
- Eklentinin Google Cloud projesinde "Cloud Logging API"yi etkinleştirin. Bir API'yi etkinleştirmek için Bulut projesi oluşturma ve API'yi etkinleştirme bölümünü inceleyin.
- Eklentiyi Google Workspace Marketplace'te yayınlayın. Marketplace'te bir eklenti yayınlamak için Uygulama yayınlama bölümüne bakın.
Sorgu eklentisi hata günlükleri
Bir eklentinin günlüklerini almak için:
- Google Cloud Console'u açın.
- "Google Cloud Platform"un yanındaki Aşağı oku tıklayın ve eklenti projesini seçin.
- Sol üst köşede Menü > Günlük'ü tıklayın. Günlük Gezgini açılır.
Eklenti hata günlükleri için sorgu oluşturucuya aşağıdaki sorguyu girin:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"Son hataları görmek için Sorguyu çalıştır'ı tıklayın. Hataları oluştukları sırada görmek için Günlük akışı başlat'ı tıklayın. Eklenti hata günlükleri, "Sorgu sonuçları" bölmesinde görünür.
Cloud Günlük Gezgini ve sorgu yazma hakkında daha fazla bilgi edinmek için aşağıdakilere bakın:
Hata günlük kaydını etkinleştirme veya devre dışı bırakma
Varsayılan olarak hata günlük kaydı etkindir. Hata günlük kaydı etkinleştirildiğinde manifest dosyasında şunlar bulunur:
"exceptionLogging": "STACKDRIVER",
Hata günlük kaydını devre dışı bırakmak için manifest dosyasında "exceptionLogging": "STACKDRIVER", ifadesini aşağıdaki satırla değiştirin:
// Disable error logging
"exceptionLogging": "NONE"
Hata günlük kaydını yeniden etkinleştirmek için "exceptionLogging": "NONE" değerini "exceptionLogging": "STACKDRIVER", ile değiştirin.
Dikkat edilmesi gereken noktalar
Cloud Günlük Gezgini'ndeki eklenti hata günlükleriyle çalışırken aşağıdaki noktaları göz önünde bulundurun:
- Eklentiler yalnızca Günlük Gezgini'ndeki hataları günlüğe kaydeder. Diğer günlük türleri kaydedilmez.
- Hata mesajları her zaman İngilizce yazılır.
- Cloud Logging ücrete tabidir. Cloud Logging fiyatlandırması hakkında daha fazla bilgi için Google Cloud Gözlemlenebilirliği fiyatlandırmasını inceleyin.