Google Workspace eklentileri için sorgu hatası günlükleri

Yayınlanan bir Google Workspace eklentisi hata döndürdüğünde 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 sorgulandığı açıklanmaktadır. Bu sayede:

  • 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 hangi hataların oluştuğunu öğrenin.
  • Sorunları düzeltmenize yardımcı olacak açıklayıcı hata mesajlarını okuyun.

Ön koşullar

Eklenti hata günlüklerini sorgulamadan önce:

Eklenti hata günlüklerini sorgulayın

Bir eklentinin günlüklerini almak için:

  1. Google Cloud Console'u açın.
  2. "Google Cloud Platform"un yanındaki aşağı oku tıklayın ve eklenti projesini seçin.
  3. Sol üst köşede Menü > Günlük'ü tıklayın. Günlük Gezgini açılır.

  4. Eklenti hata günlükleri için sorgu oluşturucuda aşağıdaki sorguyu girin:

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

  5. Son hataları görmek için Sorguyu çalıştır'ı tıklayın. Hataları oluştukça görmek için Yayın 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ğıdakileri inceleyin:

Hata günlüğünü etkinleştirme veya devre dışı bırakma

Hata günlüğe kaydetme özelliği varsayılan olarak etkindir. Hata günlüğe kaydetme etkinleştirildiğinde manifest dosyasında şunlar 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 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'nde hataları günlüğe kaydeder. Diğer günlük türleri kaydedilmez.
  • Hata mesajları her zaman İngilizce olarak yazılır.
  • Cloud Logging maliyetlidir. Cloud Logging fiyatlandırması hakkında daha fazla bilgi için Google Cloud Gözlemlenebilirlik fiyatlandırması başlıklı makaleyi inceleyin.