Fehlerprotokolle bei Abfragen für Google Chat-Apps

In diesem Leitfaden wird beschrieben, wie Sie Chat-App-Fehlerprotokolle im Google Cloud Log-Explorer abfragen. Sie können Logs abfragen, um:

  • Herausfinden, ob Nutzer Fehler feststellen
  • Sie können sehen, wie oft Fehler auftreten und welche am häufigsten sind.
  • Lesen Sie beschreibende Fehlermeldungen und Protokolldaten, die Ihnen helfen, die Fehler zu beheben.

Vorbereitung

Abfragefehlerprotokolle

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

    Log-Explorer aufrufen

  2. Aktivieren Sie Abfrage anzeigen, um den Query Builder zu öffnen.

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

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

  4. Klicken Sie auf Abfrage ausführen, um die letzten Fehler aufzurufen. Wenn Sie Fehler direkt sehen möchten, klicken Sie auf Streamprotokolle. Chat-App-Fehlerprotokolle werden im Bereich „Abfrageergebnisse“ angezeigt.

Weitere Informationen zum Google Cloud Log-Explorer und zum Erstellen von Abfragen finden Sie in der Log-Explorer-Dokumentation in diesen Anleitungen:

Fehlermeldung aus einem Protokoll lesen

Nachdem Sie ein Fehlerprotokoll abgefragt haben, können Sie sich einzelne Protokolle ansehen, die aus einer JSON-Nutzlast bestehen, die das Protokoll beschreibt. Bei Fehlern in der Chat-App enthält die JSON-Datei die Fehlermeldung unter jsonPayload.error.message. Im folgenden Beispiellog wird beispielsweise in der Fehlermeldung angegeben, dass die Ausführung einer Apps Script-Funktion fehlgeschlagen ist:

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 Chat-App-Fehlerprotokollen im Google Cloud Log-Explorer Folgendes:

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

    • ERROR

    Logs zu ähnlichen Diensten können auch bei der Fehlerbehebung einer Chat-App helfen. Wenn eine Chat-App beispielsweise mit Google Cloud Functions bereitgestellt wird, sollten Sie im Log-Explorer auch nach Cloud Functions-Logs suchen.

  • Fehlermeldungen sind immer auf Englisch.

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

Wenn Sie nach der Abfrage der Fehlerprotokolle Fehler finden, finden Sie in den folgenden Anleitungen Hilfe zur Fehlerbehebung: