Fehlerprotokolle bei Abfragen für Google Chat-Apps

In dieser Anleitung wird beschrieben, wie Sie Fehlerlogs der Chat-App im Log-Explorer von Google Cloud abfragen. Abfrageprotokolle für:

  • Sie erfahren, ob bei Nutzern Fehler auftreten.
  • Sehen Sie sich an, wie oft und welche Fehler am häufigsten auftreten.
  • Lesen Sie beschreibende Fehlermeldungen und Protokolldaten, die Ihnen bei der Fehlerbehebung helfen.

Vorbereitung

Abfragefehlerlogs

  1. Klicken Sie in der Google Cloud Console auf das Dreistrich-Menü. > Weitere Produkte > Logging > Log-Explorer.

    Zum Log-Explorer

  2. Aktivieren Sie bei Bedarf Abfrage anzeigen, um den Query Builder anzuzeigen.

  3. Geben Sie für Fehlerlogs der Chat-App die folgende Abfrage ein:

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

  4. Klicken Sie auf Abfrage ausführen, um aktuelle Fehler zu sehen. Sie können auch auf Logs streamen klicken, um sich die Fehler in Echtzeit anzusehen. Fehlerprotokolle für Chat-Apps werden in den Abfrageergebnissen angezeigt .

Weitere Informationen zum Log-Explorer von Google Cloud und zum Schreiben von Abfragen finden Sie in den folgenden Leitfäden in der Dokumentation zum Log-Explorer:

Fehlermeldung aus einem Log lesen

Nach der Abfrage eines Fehlerlogs können Sie sich einzelne Logs ansehen, die aus einer JSON-Nutzlast bestehen, die das Log beschreibt. Bei Fehlern in der Chat-App enthält die JSON-Datei die Fehlermeldung unter jsonPayload.error.message. Im folgenden Beispielprotokoll besagt die Fehlermeldung beispielsweise, dass eine Apps Script-Funktion nicht ausgeführt werden konnte:

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

Hinweise

Beachten Sie bei der Arbeit mit Fehlerlogs für Chat-Apps im Log-Explorer von Google Cloud die folgenden Hinweise:

  • Für Google Chat-Apps enthält der Log-Explorer derzeit Protokolle mit den folgenden Schweregraden, die bei der Fehlerbehebung einer nicht funktionierenden App hilfreich sind:

    • ERROR

    Protokolle zugehöriger Dienste können auch zur Fehlerbehebung in einer Chat-App beitragen. Wenn beispielsweise eine Chat-App mit Google Cloud Functions bereitgestellt wird, empfiehlt es sich, im Log-Explorer nach Cloud Functions-Logs zu suchen.

  • Fehlermeldungen werden immer auf Englisch verfasst.

  • Für Cloud Logging fallen Kosten an. Weitere Informationen zu den Preisen für Cloud Logging finden Sie unter Operations-Suite von Google Cloud – Preise.

Wenn Sie nach dem Abfragen von Fehlerprotokollen Fehler finden, lesen Sie die folgenden Leitfäden zur Behebung von Fehlern: