In dieser Anleitung wird beschrieben, wie Sie Fehlerlogs für Chat-Apps im Google Cloud Log-Explorer abfragen. Abfrageprotokolle für:
- Erfahren, ob bei Nutzern Fehler auftreten
- Sehen Sie sich an, wie häufig und welche Fehler am häufigsten auftreten.
- Lesen Sie beschreibende Fehlermeldungen und Protokolldaten, die Ihnen bei der Fehlerbehebung helfen.
Voraussetzungen
- Ein Google Workspace-Konto mit Zugriff auf Google Chat.
- Eine Chat-App. Folgen Sie quickstart, um eine Chat-App zu erstellen.
- Aktivieren Sie die Fehlerprotokollierung für die Chat App.
Logs zu Abfragefehlern
Klicken Sie in der Google Cloud Console auf Menü > Weitere Produkte > Logging > Log-Explorer.
Aktivieren Sie zum Aufrufen von Query Builder die Option Abfrage anzeigen.
Geben Sie für Fehlerlogs für Chat-Apps die folgende Abfrage ein:
severity=ERROR resource.type="chat.googleapis.com/Project"
Klicken Sie auf Abfrage ausführen, um die letzten Fehler zu sehen. Wenn Sie Fehler sofort sehen möchten, klicken Sie auf Logs streamen. Fehlerlogs für Chat-Apps werden im Bereich „Abfrageergebnisse“ angezeigt.
Weitere Informationen zum Google Cloud-Log-Explorer und zum Schreiben von Abfragen finden Sie in den folgenden Leitfäden in der Dokumentation zum Log-Explorer:
Fehlermeldung aus einem Protokoll lesen
Nach der Abfrage eines Fehlerlogs können Sie einzelne Logs aufrufen, die aus einer JSON-Nutzlast bestehen, die das Log beschreibt. Bei Chat-App-Fehlern enthält die JSON-Datei die Fehlermeldung unter jsonPayload.error.message
. Im folgenden Beispielprotokoll wird beispielsweise angezeigt, 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"
}
Wissenswertes
Beachten Sie bei der Arbeit mit Fehlerlogs für Chat-Anwendungen im Google Cloud Log-Explorer die folgenden Hinweise:
Für Google Chat-Apps enthält der Log-Explorer derzeit Protokolle mit den folgenden Schweregraden, die bei der Fehlerbehebung für defekte Apps helfen:
ERROR
Logs zugehöriger Dienste können auch beim Debuggen einer Chat-App helfen. Wenn eine Chat-App beispielsweise mit Google Cloud Functions bereitgestellt wird, empfiehlt es sich, den Log-Explorer auch für Cloud Functions-Logs zu prüfen.
Fehlermeldungen werden immer auf Englisch geschrieben.
Für Cloud Logging fallen Kosten an. Weitere Informationen zu den Cloud Logging-Preisen finden Sie unter Preise für die Operations-Suite von Google Cloud.
Weitere Informationen
Wenn Sie nach dem Abfragen von Fehlerlogs Fehler finden, lesen Sie die folgenden Anleitungen zur Fehlerbehebung:
- Informationen zum Beheben von Fehlern in Google Chat-Apps wie „Die App reagiert nicht“, „Die Google Chat API ist nur für Google Workspace-Nutzer verfügbar“ oder „Nutzer können aus Gruppenbereichen ausgeschlossen werden“.
- Informationen zum Beheben von Kartenfehlern, z. B. bei Kartenmeldungen, Dialogfeldern oder Linkvorschauen, die nicht gerendert werden oder nicht wie erwartet funktionieren
- Informationen zum Debuggen