Để 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ý:
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:
ERROR
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.
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:
Tìm hiểu cách khắc phục lỗi ứng dụng Google Chat, chẳng hạn như "Ứng dụng không phản hồi", "Google Chat API chỉ dành cho người dùng Google Workspace" hoặc "Người dùng có thể bị loại khỏi không gian".
Tìm hiểu cách khắc phục lỗi về thẻ, chẳng hạn như thông báo, hộp thoại hoặc bản xem trước đường liên kết của thẻ không hiển thị hoặc hoạt động như mong đợi.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["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)"]]
