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.
- Hataları 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 Cloud 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üğüne kaydetme özelliği varsayılan olarak etkindir. Hata günlüğü etkinleştirildiğinde manifest dosyasında aşağıdakiler bulunur:
"exceptionLogging": "STACKDRIVER",
Hata günlüğünü devre dışı bırakmak için manifest dosyasında "exceptionLogging": "STACKDRIVER", yerine aşağıdaki satırı ekleyin:
// 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 Logs Explorer'da eklenti hata günlükleriyle çalışırken şu hususları 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 maliyete neden olur. Cloud Logging fiyatlandırması hakkında daha fazla bilgi için Google Cloud Observability fiyatlandırması sayfasına bakın.