Truy vấn nhật ký lỗi đối với các ứng dụng trong Google Chat

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 đám mây của Google. Truy vấn nhật ký đến:

  • 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 sửa lỗi.

Điều kiện tiên quyết

Nhật ký lỗi truy vấn

  1. Trong bảng điều khiển Google Cloud, hãy nhấp vào Trình đơn > Sản phẩm khác > Ghi nhật ký > Trình khám phá nhật ký.

    Chuyển đến Trình khám phá nhật ký

  2. Nếu cần, để hiển thị trình tạo truy vấn, hãy bật Hiển thị truy vấn.

  3. Đố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"

  4. Để 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 một nhật ký lỗi, bạn có thể xem từng nhật ký chứa một phần tải dữ liệu 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 đây, thông báo lỗi cho biết hàm của 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 xử lý nhật ký lỗi của ứng dụng Chat trong Trình khám phá nhật ký trên đám mây của Google, hãy lưu ý những điểm cần cân nhắc sau đây:

  • Đố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ố ứng dụng gặp sự cố:

    • ERROR

    Nhật ký về các dịch vụ liên quan cũng có thể giúp gỡ lỗi cho một ứng dụng trong Chat. Ví dụ: nếu triển khai một ứng dụng trong Chat bằng Google Cloud Functions, thì tốt nhất là bạn nên kiểm tra nhật ký của Trình khám phá nhật ký cho cả nhật ký của Cloud Functions.

  • Các 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 tính năng Ghi nhật ký trên đám mây, hãy tham khảo giá bộ công cụ vận hành của Google Cloud.

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: