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 sẽ trả về 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 sẽ được ghi lại 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 trong Cloud Logs Explorer để bạn có thể:
- 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à tần suất xảy ra lỗi nhiều nhất.
- Hãy đọc các thông báo lỗi có tính mô tả để biết cách 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 dự án Google Cloud của tiện ích bổ sung. Để bật API, hãy tham khảo phần Tạo dự án Google Cloud và bật API.
- Phát hành tiện ích bổ sung trên Google Workspace Marketplace. Để phát hành tiện ích bổ sung trên Marketplace, hãy tham khảo bài viết Xuất bản ứng dụng.
Nhật ký lỗi của tiện ích bổ sung truy vấn
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", hãy nhấp vào 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, trong trình tạo truy vấn, hãy nhập 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 các lỗi khi chúng 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 ngăn "Kết quả truy vấn".
Để biết thêm thông tin về Trình khám phá nhật ký trên đám mây và các truy vấn ghi, hãy tham khảo những nội dung sau:
Bật hoặc tắt tính năng ghi nhật ký lỗi
Theo mặc định, tính năng ghi nhật ký lỗi được bật. Khi bật tính năng ghi nhật ký lỗi, tệp kê khai sẽ có các nội dung sau:
"exceptionLogging": "STACKDRIVER",
Để tắt tính năng ghi nhật ký lỗi, hãy thay thế "exceptionLogging": "STACKDRIVER", bằng dòng sau trong 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 Trình khám phá nhật ký trên đám mây, hãy lưu ý những điểm cần cân nhắc sau:
- Tiện ích bổ sung chỉ ghi lỗi trong Trình khám phá nhật ký. Các loại nhật ký khác sẽ không được ghi lại.
- 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ẽ 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á của Google Cloud Observability (Khả năng quan sát của Google Cloud).