In diesem Leitfaden wird beschrieben, wie Sie Chat-App-Fehlerprotokolle im Google Cloud Log-Explorer abfragen. Sie können Logs abfragen, um:
- 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
- Sie benötigen ein Google Workspace-Konto mit Zugriff auf Google Chat.
- Eine Chat-App. Folgen Sie dieser Kurzanleitung, um eine Chat-App zu erstellen.
- Aktivieren Sie die Fehlerprotokollierung für die Chat App.
Abfragefehlerprotokolle
Klicken Sie in der Google Cloud Console auf das Dreistrich-Menü. > Weitere Produkte > Logging > Log-Explorer.
Aktivieren Sie bei Bedarf Abfrage anzeigen, um den Query Builder anzuzeigen.
Geben Sie für Fehlerlogs der Chat-App die folgende Abfrage ein:
severity=ERROR resource.type="chat.googleapis.com/Project"
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
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
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 werden immer auf Englisch verfasst.
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.
Weitere Informationen
Wenn Sie nach der Abfrage der Fehlerprotokolle Fehler finden, finden Sie in den folgenden Anleitungen Hilfe zur Fehlerbehebung:
- Weitere Informationen zum Beheben von Fehlern in der Google Chat App wie „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. Kartenmeldungen, Dialogfelder oder Linkvorschauen, die nicht wie erwartet gerendert oder funktionieren
- Weitere Informationen zur Fehlerbehebung