Khi một tiện ích bổ sung Google Workspace đã xuất bản 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, các lỗi này sẽ được ghi vào 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 Trình khám phá nhật ký trên đám mây để 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à lỗi nào thường gặp nhất.
- Đọc thông báo lỗi mô tả để giúp bạn khắc phục lỗi.
Đ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" (API ghi nhật ký trên đám mây) 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 trên Cloud và bật API.
- Xuất bản 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 phần Phát hành ứng dụng.
Truy vấn nhật ký lỗi tiện ích bổ sung
Cách lấy nhật ký cho một tiện ích bổ sung:
- Mở Google Cloud Console.
- Bên cạnh "Google Cloud Platform", hãy nhấp vào biểu tượng Mũi tên xuống rồi chọn dự án 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 lỗi khi lỗi xảy ra, hãy nhấp vào Nhật ký luồng. Nhật ký lỗi của tiện ích bổ sung sẽ 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ách viết truy vấn, hãy tham khảo 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 sẽ được bật. Khi tính năng ghi nhật ký lỗi được bật, 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 làm việc với 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ều cần cân nhắc sau:
- Tiện ích bổ sung chỉ ghi nhật ký 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.
- Cloud Logging có tính phí. Để biết thêm thông tin về giá của Cloud Logging, hãy tham khảo giá của dịch vụ Quan sát của Google Cloud.