Google Workspace Eklentileri için hata günlükleri sorgu

Yayınlanan bir Google Workspace eklentisi hata döndürdüğünde eklenti arayüzü, aşağıdaki gibi genel bir mesaj "Eklenti yürütülürken bir sorun oluştu." Ancak bu hatalar Cloud Günlük Gezgini'ne günlüğe kaydedildi.

Not: Apps Komut Dosyası için eklentisi test olarak dağıtıldığında, hem Cloud Günlük Gezgini'nde hem de ekleyebilirsiniz.

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

Bunun gibi hata mesajları yararlı olsa da, ek bilgiler götürebilirsiniz. En iyi uygulama olarak, daha fazla bilgi edinin. Test hakkında daha fazla bilgi için daha fazla bilgi edinmek için Google Workspace eklentilerini test edin ve hatalarını ayıklayın.

Bu kılavuzda, Böylece şunları yapabilirsiniz:

• Kullanıcıların hatalarla karşılaşıp karşılaşmadığını öğrenin.
• Hataların ne sıklıkta ortaya çıktığını ve hangilerinde en sık olduğunu görün.
• Düzeltmenize yardımcı olacak açıklayıcı hata mesajlarını okuyun.

Ön koşullar

Eklenti hata günlüklerini sorgulamadan önce:

• "Cloud Logging API"yi etkinleştirin eklentinin Google Cloud projesi. Bir API'yi etkinleştirmek için şuraya bakın: Bir Cloud projesi oluşturun ve API'yi etkinleştirin.
• Eklentiyi Google Workspace Marketplace'te yayınlayın. Sayfada bir eklenti yayınlamak için Pazar Yeri, Uygulama yayınlayın.

Sorgu eklentisi hata günlükleri

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

1. Google Cloud Console'u açın.
2. "Google Cloud Platform"un yanında Aşağı oku tıklayın ve bir e-posta alırsınız.
3. Sol üst köşeden Menü'yü tıklayın. > Günlük kaydı. Günlük Gezgini açılır.

4. Eklenti hata günlükleri için sorgu oluşturucuda şu sorgu:

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

5. Son hataları görmek için Sorguyu çalıştır'ı tıklayın. Ya da hataları otomatik olarak Günlük akışı başlat'ı tıklayın. Eklenti hata günlükleri "Query results" (Sorgu sonuçları) bölmesini de kullanabilirsiniz.

Cloud Günlük Gezgini ve sorguları yazma hakkında daha fazla bilgi için şu:

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

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ı şunlara sahiptir:

"exceptionLogging": "STACKDRIVER",

Hata günlük kaydını devre dışı bırakmak için "exceptionLogging": "STACKDRIVER", manifesto dosyası:

// Disable error logging
"exceptionLogging": "NONE"

Hata günlük kaydını yeniden etkinleştirmek için "exceptionLogging": "NONE" öğesini şununla değiştirin: "exceptionLogging": "STACKDRIVER",.

Dikkat edilmesi gereken noktalar

Cloud Günlükleri'ndeki eklenti hata günlükleriyle çalışırken aşağıdaki noktaları göz önünde bulundurun:

• Eklentiler, hataları yalnızca Günlük Gezgini'ne kaydeder. Diğer günlük türleri şunlardır: kaydedilmedi.
• Hata mesajları her zaman İngilizce yazılır.
• Cloud Logging'in ücretlendirilmesi gerekir. Cloud Logging hakkında daha fazla bilgi fiyatlandırmasını incelemek için Google Cloud Gözlemlenebilirlik fiyatlandırmasına bakın.