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.
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:
- Google Cloud Console'u açın.
- "Google Cloud Platform"un yanında Aşağı oku tıklayın ve bir e-posta alırsınız.
- Sol üst köşeden Menü'yü tıklayın. > Günlük kaydı. Günlük Gezgini açılır.
Eklenti hata günlükleri için sorgu oluşturucuda şu sorgu:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"
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:
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.