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.

Not: Apps Script'te eklentiniz test olarak dağıtılırsa hatalar hem Cloud Günlükleri Gezgini'nde hem de eklenti arayüzünde bildirilir.

Örneğin, bir eklenti test dağıtımı arayüzünde şu hata mesajını gösterebilir: TypeError: card.INVALIDFUNCTIONNAME is not a function [line: 33, function: getContextualAddOn, file: GetContextualAddOn].

Bu tür hata mesajları faydalı olsa da Günlük Gezgini'nde ek bilgiler bulabilirsiniz. En iyi uygulama olarak daha fazla bilgi için hata günlüklerini sorgulayın. Eklenti dağıtımlarını test etme hakkında daha fazla bilgi için Google Workspace eklentilerini test etme ve hata ayıklama başlıklı makaleyi inceleyin.

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:

• 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 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:

• Günlük Gezgini'ni kullanma
• Sorgu oluşturma

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.