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 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

Truy vấn nhật ký lỗi

  1. Trong Google API Console, hãy nhấp vào Trình đơn > Thêm sản phẩm > Logging > Logs Explorer.

    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 chúng xảy ra, hãy nhấp vào Truyền trực tuyến nhật ký. 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ề Google Cloud Logs Explorer và cách viết truy vấn, hãy xem các hướng dẫn sau trong tài liệu về Logs Explorer:

Đọ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 các nhật ký riêng lẻ bao gồm một tải trọng JSON mô tả nhật ký. Đối với 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, thông báo lỗi cho biết rằng 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 làm việc với nhật ký lỗi của ứng dụng Chat trong Google Cloud Logs Explorer, hãy lưu ý những điều sau:

  • Đối với các ứng dụng Google Chat, Logs Explorer 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 ứng dụng Chat. Ví dụ: nếu bạn triển khai ứng dụng Chat bằng các hàm Google Cloud Run, thì hãy kiểm tra nhật ký của các hàm Cloud Run trong Logs Explorer.

  • 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ộ hoạt động Google Cloud.

Sau khi truy vấn nhật ký lỗi, nếu bạn phát hiệ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: