Google Chat uygulamaları için sorgu hata günlükleri

Bu kılavuzda, Google Cloud Günlük Gezgini'nde Chat uygulaması hata günlüklerinin nasıl sorgulandığı açıklanmaktadır. Günlükleri şu amaçlarla sorgulayın:

  • 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.
  • Hataları düzeltmenize yardımcı olacak açıklayıcı hata mesajlarını ve günlük verilerini okuyun.

Ön koşullar

Sorgu hata günlükleri

  1. Google Cloud Console'da Menü > Diğer ürünler > Günlük kaydı > Günlük Gezgini'ni tıklayın.

    Günlük Gezgini'ne gidin

  2. Gerekirse sorgu oluşturucuyu göstermek için Sorguyu göster'i etkinleştirin.

  3. Chat uygulaması hata günlükleri için aşağıdaki sorguyu girin:

    severity=ERROR
resource.type="chat.googleapis.com/Project"

  4. 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. 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ılavuzları inceleyin:

Günlükten hata mesajı okuma

Bir hata günlüğünü sorguladıktan sonra, günlüğü açıklayan bir JSON yükünden oluşan günlükleri tek tek görüntüleyebilirsiniz. Chat uygulaması hatalarında JSON, jsonPayload.error.message alanında hata mesajını içerir. Örneğin, aşağıdaki örnek günlükte hata mesajında bir Apps Komut Dosyası işlevinin yürütülemediği belirtilmektedir:

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 aşağıdaki noktaları göz önünde bulundurun:

  • Google Chat uygulamaları için Günlük Gezgini şu anda, düzgün çalışmayan bir uygulamayla ilgili sorunları gidermeye yardımcı olan aşağıdaki önem derecelerine sahip günlükleri içerir:

    • ERROR

    İlgili hizmetlerin günlükleri de Chat uygulamasının hatalarını ayıklamanıza yardımcı olabilir. Örneğin, bir Chat uygulaması Google Cloud Functions kullanılarak dağıtılıyorsa Cloud Functions günlükleri için Günlük Gezgini'ni de kontrol etmek en iyi uygulamadır.

  • 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'un işlem paketi fiyatlandırması başlıklı makaleyi inceleyin.

Hata günlüklerini sorguladıktan sonra hata bulursanız hataları düzeltmeyle ilgili yardım için aşağıdaki kılavuzları inceleyin: