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 Trình khám phá nhật ký trên Google Cloud. 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 cũng như lỗi nào xảy ra nhiều 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
- Một tài khoản Google Workspace có quyền truy cập vào Google Chat.
- Ứng dụng Chat. Để tạo một ứng dụng trong Chat, hãy làm theo hướng dẫn bắt đầu nhanh này.
- Bật tính năng ghi nhật ký lỗi cho ứng dụng Chat.
Nhật ký lỗi truy vấn
Trong Google Cloud Console, hãy nhấp vào Trình đơn > Các sản phẩm khác > Ghi nhật ký > Trình khám phá nhật ký.
Nếu cần, để hiển thị trình tạo truy vấn, hãy bật tuỳ chọn Hiển thị truy vấn.
Đối với nhật ký lỗi ứ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 xảy ra, hãy nhấp vào Nhật ký truyền trực tuyến. Nhật ký lỗi của ứng dụng Chat sẽ xuất hiện trong phần "Kết quả truy vấn" .
Để tìm hiểu thêm về Trình khám phá nhật ký của Google Cloud và cách viết các 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 từ 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 xảy ra với ứng dụng Chat, tệp JSON sẽ hiển thị thông báo lỗi tại jsonPayload.error.message
. Ví dụ: trong nhật ký mẫu sau, 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"
}
Những yếu tố nên cân nhắc
Khi bạn làm việc với nhật ký lỗi ứng dụng Chat trong Trình khám phá nhật ký trên 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 nhằm giúp khắc phục sự cố cho ứng dụng:
ERROR
Nhật ký của các dịch vụ có liên quan cũng có thể giúp gỡ lỗi ứng dụng Chat. Ví dụ: nếu một ứng dụng Chat được triển khai bằng Google Cloud Functions, thì tốt nhất bạn nên kiểm tra cả nhật ký của Cloud Functions trong Trình khám phá nhật ký.
Thông báo lỗi luôn được viết bằng tiếng Anh.
Tính năng Ghi nhật ký trên đám mây sẽ làm phát sinh chi phí. Để biết thêm thông tin về giá của Cloud Logging, hãy tham khảo bảng giá của bộ công cụ vận hành của Google Cloud.
Chủ đề có liên quan
Sau khi truy vấn nhật ký lỗi, nếu bạn tìm thấy lỗi, hãy xem những hướng dẫn khắc phục lỗi sau đây:
- Tìm hiểu cách khắc phục lỗi ứng dụng Google Chat như "Ứng dụng không phản hồi", "Chỉ người dùng Google Workspace mới có thể sử dụng Google Chat API" hoặc "Người dùng có thể bị loại trừ khỏi không gian".
- Tìm hiểu cách khắc phục lỗi thẻ như thông báo thẻ, hộp thoại hoặc bản xem trước đường liên kết không hiển thị hoặc không hoạt động như mong đợi.
- Tìm hiểu cách gỡ lỗi.