Nhật ký lỗi truy vấn cho tiện ích bổ sung của Google Workspace

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.

Lưu ý: Đối với Apps Script, nếu tiện ích bổ sung của bạn được triển khai dưới dạng kiểm thử, thì lỗi sẽ được báo cáo trong cả Trình khám phá nhật ký trên đám mây và trong giao diện tiện ích bổ sung.

Ví dụ: một quá trình triển khai kiểm thử tiện ích bổ sung có thể hiển thị thông báo lỗi như sau trong giao diện: TypeError: card.INVALIDFUNCTIONNAME is not a function [line: 33, function: getContextualAddOn, file: GetContextualAddOn].

Mặc dù thông báo lỗi như thế này rất hữu ích, nhưng bạn có thể xem thêm thông tin trong Trình khám phá nhật ký. Tốt nhất là bạn nên truy vấn nhật ký lỗi để biết thêm thông tin. Để biết thêm thông tin về việc kiểm thử các lượt triển khai tiện ích bổ sung, hãy tham khảo bài viết Kiểm thử và gỡ lỗi tiện ích bổ sung của Google Workspace.

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:

1. Mở Google Cloud Console.
2. 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.
3. Ở 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.

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

5. Để 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:

• Sử dụng Trình khám phá nhật ký
• Tạo truy vấn

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.