Khi một tiện ích bổ sung của Google Workspace đã phát hành trả về lỗi, giao diện tiện ích bổ sung trả về một thông báo chung là "Đã xảy ra lỗi khi thực thi tiện ích bổ sung." Tuy nhiên, những lỗi này ghi vào Cloud Logs Explorer (Trình khám phá nhật ký trên đám mây).
Hướng dẫn này mô tả cách truy vấn nhật ký lỗi của tiện ích bổ sung Trình khám phá nhật ký trên đám mây giúp bạ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 các thông báo lỗi mô tả để giúp bạn khắc phục.
Điều kiện tiên quyết
Trước khi truy vấn nhật ký lỗi của tiện ích bổ sung:
- Bật "Cloud Logging API" trong tiện ích bổ sung Dự án trên Google Cloud. Để bật API, hãy tham khảo Tạo một dự án trên Google Cloud và bật API.
- Xuất bản tiện ích bổ sung trên Google Workspace Marketplace. Để xuất bản một tiện ích bổ sung trên Thị trường, tham khảo Xuất bản ứng dụng.
Truy vấn nhật ký lỗi của tiện ích bổ sung
Cách tải nhật ký của một tiện ích bổ sung:
- Mở bảng điều khiển Google Cloud.
- Bên cạnh "Google Cloud Platform", nhấp vào biểu tượng Mũi tên xuống rồi chọn dự án tiện ích bổ sung.
- Ở góc trên cùng bên trái, hãy nhấp vào biểu tượng Trình đơn > Ghi nhật ký. Trình khám phá nhật ký sẽ mở ra.
Đối với nhật ký lỗi của tiện ích bổ sung, hãy nhập trong trình tạo truy vấn truy vấn sau:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"Để 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 tiện ích bổ sung xuất hiện trong "Kết quả truy vấn" .
Để biết thêm thông tin về Cloud Logs Explorer và ghi truy vấn, hãy tham khảo như sau:
Bật hoặc tắt tính năng ghi nhật ký lỗi
Tính năng ghi nhật ký lỗi được bật theo mặc định. Khi tính năng ghi nhật ký lỗi được bật, tệp kê khai có:
"exceptionLogging": "STACKDRIVER",
Để tắt tính năng ghi nhật ký lỗi, hãy thay thế
"exceptionLogging": "STACKDRIVER", với dòng sau trong phần
tệp kê khai:
// Disable error logging
"exceptionLogging": "NONE"
Để bật lại tính năng ghi nhật ký lỗi, hãy thay thế "exceptionLogging": "NONE" bằng
"exceptionLogging": "STACKDRIVER",.
Những yếu tố nên cân nhắc
Khi bạn xử lý nhật ký lỗi của tiện ích bổ sung trong Nhật ký trên đám mây Explorer, hãy lưu ý những điểm cần cân nhắc sau đây:
- Tiện ích bổ sung chỉ ghi lại lỗi trong Logs Explorer (Trình khám phá nhật ký). Các loại nhật ký khác là chưa được ghi lại.
- 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ề tính năng Ghi nhật ký trên đám mây giá, hãy tham khảo giá của tính năng Quan sát của Google Cloud.