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

Sorgu hata günlükleri

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

    Günlük Gezgini'ne git

  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ş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.

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: