查询 Google Chat 应用的错误日志
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
本指南介绍了如何在 Google Cloud 日志浏览器中查询 Chat 应用错误日志。查询日志以:
- 了解用户是否遇到错误。
- 查看错误发生的频率以及最常发生的错误。
- 阅读有助于您修复错误的描述性错误消息和日志数据。
前提条件
- 拥有 Google Chat 访问权限的 Google Workspace 账号。
- 一个 Chat 应用。如需构建 Chat 应用,请按照此快速入门操作。
- 为 Chat 应用开启错误日志记录功能。
查询错误日志
在 Google Cloud 控制台中,依次点击菜单
menu
> 更多产品
> 日志记录
> 日志浏览器。
前往日志浏览器
如有必要,请开启显示查询以显示查询构建器。
对于 Chat 应用错误日志,请输入以下查询:
severity=ERROR
resource.type="chat.googleapis.com/Project"
如需查看近期发生的错误,请点击运行查询。或者,如需查看错误发生情况,请点击直播日志。聊天应用错误日志会显示在“查询结果”窗格中。
如需详细了解 Google Cloud 日志浏览器和如何编写查询,请参阅日志浏览器文档中的以下指南:
从日志中读取错误消息
查询错误日志后,您可以查看各个日志,这些日志包含描述日志的 JSON 载荷。对于 Chat 应用错误,JSON 会在 jsonPayload.error.message
中包含错误消息。例如,在以下示例日志中,错误消息表明某个 Apps 脚本函数未能执行:
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"
}
注意事项
在 Google Cloud 日志浏览器中使用 Chat 应用错误日志时,请注意以下事项:
对于 Google Chat 应用,日志浏览器目前包含以下严重程度的日志,可帮助排查应用故障:
相关服务的日志也有助于调试 Chat 应用。例如,如果 Chat 应用是使用 Google Cloud Functions 部署的,那么最好也检查 Cloud Functions 日志的日志浏览器。
错误消息始终以英文显示。
Cloud Logging 会产生费用。如需详细了解 Cloud Logging 价格,请参阅 Google Cloud 的运维套件价格。
查询错误日志后,如果您发现错误,请参阅以下指南,获取有关修正错误的帮助:
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-04。
[null,null,["最后更新时间 (UTC):2025-08-04。"],[[["\u003cp\u003eThis guide explains how to use Google Cloud Logs Explorer to query error logs for your Google Chat apps.\u003c/p\u003e\n"],["\u003cp\u003eBy querying logs, you can identify, understand the frequency of, and troubleshoot errors within your Chat app using descriptive error messages and log data.\u003c/p\u003e\n"],["\u003cp\u003eError logs can be queried using a specific query within Logs Explorer and examined for details such as error messages within their JSON payload.\u003c/p\u003e\n"],["\u003cp\u003eWhen using Cloud Logging, keep in mind potential costs and that logs related to other services used by your app may also be helpful for debugging.\u003c/p\u003e\n"]]],["To query Chat app error logs, access Google Cloud Logs Explorer and use the query `severity=ERROR resource.type=\"chat.googleapis.com/Project\"`. This allows you to identify user-encountered errors, their frequency, and view descriptive error messages. Click \"Run query\" for recent errors or \"Stream logs\" for live updates. Each error log contains a JSON payload, with the error message found under `jsonPayload.error.message`. Note that logs with `ERROR` severity are included and all error messages are in English.\n"],null,["This guide describes how to query Chat app error logs in [Google Cloud Logs Explorer](https://cloud.google.com/logging/docs/view/logs-viewer-interface). Query logs to:\n\n- Learn if users encounter errors.\n- See how often errors occur, and which are most frequent.\n- Read descriptive error messages and log data that help you fix the errors.\n\nPrerequisites\n\n- A Google Workspace account with access to Google Chat.\n- A Chat app. To build a Chat app, follow this [quickstart](/workspace/chat/quickstart/gcf-app).\n- [Turn on error logging](/workspace/chat/turn-on-error-logging) for the Chat app.\n\nQuery error logs\n\n1. In the Google Cloud console, click **Menu**\n menu\n \\\u003e **More products**\n \\\u003e **Logging**\n \\\u003e **Logs Explorer**.\n\n [Go to Log Explorer](https://console.cloud.google.com/logs/query)\n2. If necessary, to show the query builder, turn on **Show query**.\n\n3. For Chat app error logs, enter the following query:\n\n severity=ERROR\n resource.type=\"chat.googleapis.com/Project\"\n\n4. To see recent errors, click **Run query** . Or, to see errors as they occur, click **Stream logs**. Chat app error logs appear in the \"Query results\" pane.\n\nTo learn more about Google Cloud Logs Explorer and writing queries, see these guides in the Logs Explorer documentation:\n\n- [View logs by using the Logs Explorer](https://cloud.google.com/logging/docs/view/logs-viewer-interface)\n- [Build queries in the Logs Explorer](https://cloud.google.com/logging/docs/view/building-queries)\n\nRead an error message from a log\n\nAfter querying an error log, you can view individual logs which consist of a JSON payload describing the log. For Chat app errors, the JSON includes the error message at `jsonPayload.error.message`. For example, in the following sample log, the error message says that an Apps Script function failed to execute: \n\nJSON \n\n {\n \"insertId\": \"\u003cvar translate=\"no\"\u003eINSERT_ID\u003c/var\u003e\",\n \"jsonPayload\": {\n \"@type\": \"type.googleapis.com/google.chat.logging.v1.ChatAppLogEntry\",\n \"error\": {\n \"code\": 9,\n \"message\": \"An Apps Script function failed to execute. To review AppsScript error logs, see \\\"Logging\\\" (https://developers.google.com/apps-script/guides/logging).\"\n },\n \"deployment\": \"\u003cvar translate=\"no\"\u003eDEPLOYMENT_ID\u003c/var\u003e\"\n },\n \"resource\": {\n \"type\": \"chat.googleapis.com/Project\",\n \"labels\": {\n \"project_id\": \"\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\"\n }\n },\n \"timestamp\": \"2022-12-06T05:24:18.697255Z\",\n \"severity\": \"ERROR\",\n \"logName\": \"projects/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e/logs/chat.googleapis.com%2Ferrors\",\n \"receiveTimestamp\": \"2022-12-06T05:24:19.207936968Z\"\n }\n\nConsiderations\n\nAs you work with Chat app error logs in Google Cloud Logs Explorer, take note of these considerations:\n\n- For Google Chat apps, Logs Explorer currently includes logs with the following severities which help troubleshoot a malfunctioning app:\n\n - `ERROR`\n\n Logs of related services can also help debug a Chat app. For example, if a Chat app is deployed using [Google Cloud Functions](https://cloud.google.com/functions/docs), then it's a best practice to check Logs Explorer for Cloud Functions logs too.\n- Error messages are always written in English.\n\n- Cloud Logging incurs a cost. For further information on Cloud Logging pricing, refer to [Google Cloud's operations suite pricing](https://cloud.google.com/stackdriver/pricing).\n\nRelated topics\n\nAfter querying error logs, if you find errors, see the following guides for help fixing errors:\n\n- [Learn how to fix Google Chat app errors](/workspace/chat/troubleshoot-chat-apps) like \"App is not responding\", \"Google Chat API is only available to Google Workspace users\", or \"Users can be excluded from spaces\".\n- [Learn how to fix card errors](/workspace/chat/troubleshoot-cards) like card messages, dialogs, or link previews not rendering or working as expected.\n- [Learn how to debug.](/workspace/chat/debug-apps)"]]