Truy vấn nhật ký lỗi đối với các ứng dụng trong Google Chat
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Hướng dẫn này mô tả cách truy vấn nhật ký lỗi của ứng dụng Chat trong Google Cloud Logs Explorer. Truy vấn nhật ký để:
- Tìm hiểu xem người dùng có gặp lỗi hay không.
- Xem tần suất xảy ra lỗi và lỗi nào thường xuyên nhất.
- Đọc thông báo lỗi mô tả và dữ liệu nhật ký giúp bạn khắc phục lỗi.
Điều kiện tiên quyết
Nhật ký lỗi truy vấn
Trong bảng điều khiển Google Cloud, hãy nhấp vào Trình đơn
menu
> Các sản phẩm khác
> Ghi nhật ký
> Trình khám phá nhật ký.
Chuyển đến Log Explorer
Nếu cần, hãy bật chế độ Hiện truy vấn để hiện trình tạo truy vấn.
Đối với nhật ký lỗi của ứng dụng Chat, hãy nhập truy vấn sau:
severity=ERROR
resource.type="chat.googleapis.com/Project"
Để xem các lỗi gần đây, hãy nhấp vào Chạy truy vấn. Hoặc để xem lỗi khi chúng xảy ra, hãy nhấp vào Nhật ký truyền phát. Nhật ký lỗi của ứng dụng Chat sẽ xuất hiện trong ngăn "Kết quả truy vấn".
Để tìm hiểu thêm về Trình khám phá nhật ký trên Google Cloud và cách viết truy vấn, hãy xem các hướng dẫn sau trong tài liệu về Trình khám phá nhật ký:
Đọc thông báo lỗi trong nhật ký
Sau khi truy vấn nhật ký lỗi, bạn có thể xem từng nhật ký bao gồm một tải trọng JSON mô tả nhật ký. Đối với các lỗi của ứng dụng Chat, JSON sẽ bao gồm thông báo lỗi tại jsonPayload.error.message
. Ví dụ: trong nhật ký mẫu sau đây, thông báo lỗi cho biết một hàm Apps Script không thực thi được:
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"
}
Lưu ý
Khi bạn làm việc với nhật ký lỗi của ứng dụng Chat trong Trình khám phá nhật ký của Google Cloud, hãy lưu ý những điều sau:
Đối với các ứng dụng Google Chat, Trình khám phá nhật ký hiện bao gồm nhật ký có các mức độ nghiêm trọng sau đây để giúp khắc phục sự cố ứng dụng bị lỗi:
Nhật ký của các dịch vụ liên quan cũng có thể giúp gỡ lỗi một ứng dụng Chat. Ví dụ: nếu một ứng dụng Chat được triển khai bằng Google Cloud Functions, thì bạn nên kiểm tra Nhật ký Explorer để xem nhật ký Cloud Functions.
Thông báo lỗi luôn được viết bằng tiếng Anh.
Cloud Logging phát sinh chi phí. Để biết thêm thông tin về giá của Cloud Logging, hãy tham khảo giá của bộ công cụ hoạt động của Google Cloud.
Sau khi truy vấn nhật ký lỗi, nếu bạn thấy lỗi, hãy xem các hướng dẫn sau để được trợ giúp khắc phục lỗi:
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-04 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-04 UTC."],[[["\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)"]]