Yayınlanmış bir Google Workspace eklentisi hata döndürdüğünde eklenti arayüzünde "Eklenti çalıştırılırken bir sorun oluştu" şeklinde genel bir mesaj gösterilir. 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:
- Kullanıcıların hatalarla karşılaşıp karşılaşmadığını öğrenin.
- Hataların ne sıklıkta oluştuğunu ve en sık görülen hataları inceleyin.
- Bu hataları düzeltmenize yardımcı olacak 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 başlıklı makaleyi inceleyin.
- Eklentiyi Google Workspace Marketplace'te yayınlayın. Marketplace'te eklenti yayınlamak için Uygulama yayınlama başlıklı makaleyi inceleyin.
Eklenti hata günlüklerini sorgulama
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üğe kaydetme'yi tıklayın. Günlük Gezgini açılır.
Eklenti hata günlükleri için sorgu oluşturucuda 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ştuğu sırada görmek için Akış günlükleri'ni de tıklayabilirsiniz. Eklenti hata günlükleri "Sorgu sonuçları" bölmesinde gösterilir.
Cloud Günlük Gezgini ve sorgu yazma hakkında daha fazla bilgi için aşağıdaki kaynaklara bakın:
Hata günlüğünü etkinleştirme veya devre dışı bırakma
Hata günlüğü varsayılan olarak etkindir. Hata günlüğü etkinleştirildiğinde manifest dosyasında şunlar bulunur:
"exceptionLogging": "STACKDRIVER",
Hata günlüğünü devre dışı bırakmak için bildirim dosyasında "exceptionLogging": "STACKDRIVER", yerine aşağıdaki satırı kullanın:
// Disable error logging
"exceptionLogging": "NONE"
Hata günlüğünü yeniden etkinleştirmek için "exceptionLogging": "NONE" yerine "exceptionLogging": "STACKDRIVER", yazın.
Dikkat edilmesi gereken noktalar
Cloud Günlük Gezgini'nde 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 olarak yazılır.
- Cloud Logging ücretlidir. Cloud Logging fiyatlandırması hakkında daha fazla bilgi için Google Cloud Observability fiyatlandırması başlıklı makaleyi inceleyin.