Bu kılavuzda, Google Cloud Günlük Gezgini'nde Chat uygulaması hata günlüklerinin nasıl sorgulanacağı açıklanmaktadır. Sorgu günlükleri:
- 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ı olacak açıklayıcı hata mesajlarını ve günlük verilerini okuyun.
Ön koşullar
- Google Chat'e erişimi olan bir Google Workspace hesabı.
- Chat uygulaması. Chat uygulaması oluşturmak için bu hızlı başlangıç kılavuzunu inceleyin.
- Chat uygulaması için hata günlüğünü etkinleştirin.
Sorgu hata günlükleri
Google API Console'da Menü > Diğer ürünler > Logging > Günlük Gezgini'ni tıklayın.
Gerekirse sorgu oluşturucuyu göstermek için Sorguyu göster'i etkinleştirin.
Chat uygulaması hata günlükleri için aşağıdaki sorguyu girin:
severity=ERROR resource.type="chat.googleapis.com/Project"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 tıklayın. Chat uygulaması hata günlükleri "Sorgu sonuçları" bölmesinde görünür.
Google Cloud Günlük Gezgini ve sorgu yazma hakkında daha fazla bilgi edinmek için Günlük Gezgini belgelerindeki şu kılavuzlara bakın:
Günlükteki hata mesajını okuma
Bir hata günlüğünü sorguladıktan sonra, günlüğü açıklayan bir JSON yükünden oluşan ayrı günlükleri görüntüleyebilirsiniz. Chat uygulaması hataları için JSON, jsonPayload.error.message konumunda hata mesajını içerir. Örneğin, aşağıdaki örnek günlükte hata mesajı, bir Apps Komut Dosyası işlevinin yürütülemediğini belirtiyor:
JSON
{
"insertId": "INSERT_ID",
"jsonPayload": {
"@type": "type.googleapis.com/google.chat.logging.v1.ChatAppLogEntry",
"error": {
"code": 9,
"message": "An Apps Script function failed to execute. To review AppsScript error logs, see \"Logging\" (https://developers.google.com/apps-script/guides/logging)."
},
"deployment": "DEPLOYMENT_ID"
},
"resource": {
"type": "chat.googleapis.com/Project",
"labels": {
"project_id": "PROJECT_ID"
}
},
"timestamp": "2022-12-06T05:24:18.697255Z",
"severity": "ERROR",
"logName": "projects/PROJECT_ID/logs/chat.googleapis.com%2Ferrors",
"receiveTimestamp": "2022-12-06T05:24:19.207936968Z"
}
Dikkat edilmesi gereken noktalar
Google Cloud Günlük Gezgini'nde Chat uygulaması hata günlükleriyle çalışırken şu hususları göz önünde bulundurun:
Google Chat uygulamaları için Günlük Gezgini, hatalı çalışan bir uygulamayla ilgili sorunları gidermeye yardımcı olan ve aşağıdaki önem derecelerine sahip günlükleri içerir:
ERROR
İlgili hizmetlerin günlükleri de bir Chat uygulamasında hata ayıklamaya yardımcı olabilir. Örneğin, Chat uygulamanızı Google Cloud Run işlevlerini kullanarak dağıtıyorsanız Cloud Run işlevleri günlükleri için de Günlük Gezgini'ni kontrol edin.
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'un işlem paketi fiyatlandırması sayfasına bakın.
İlgili konular
Hata günlüklerini sorguladıktan sonra hata bulursanız hataları düzeltme konusunda yardım için aşağıdaki kılavuzlara bakın:
- "Uygulama yanıt vermiyor", "Google Chat API yalnızca Google Workspace kullanıcıları tarafından kullanılabilir" veya "Kullanıcılar alanların dışında bırakılabilir" gibi Google Chat uygulaması hatalarını nasıl düzelteceğinizi öğrenin.
- Kart mesajları, iletişim kutuları veya bağlantı önizlemelerinin oluşturulmaması ya da beklendiği gibi çalışmaması gibi kart hatalarını nasıl düzelteceğinizi öğrenin.
- Hata ayıklamayı öğrenin.