如果發布的 Google Workspace 外掛程式傳回錯誤， 外掛程式介面會傳回一般訊息 「執行外掛程式時發生錯誤。」不過，這些錯誤 Cloud 記錄檔探索工具。
本指南說明如何在 透過 Cloud 記錄檔探索工具，您可以：
- 瞭解使用者是否會發生錯誤。
- 瞭解錯誤發生的頻率，以及錯誤發生頻率。
- 閱讀描述性的錯誤訊息，瞭解如何修正問題。
必要條件
查詢外掛程式錯誤記錄檔之前：
- 啟用「Cloud Logging API」外掛程式 存取 Google Cloud 專案如要啟用 API，請參閱 建立 Cloud 專案並啟用 API。
- 在 Google Workspace Marketplace 發布外掛程式。 如要在 市集，請參閱 發布應用程式。
查詢外掛程式錯誤記錄檔
如要取得外掛程式的記錄：
- 開啟 Google Cloud 控制台。
- 在「Google Cloud Platform」旁邊按一下向下箭頭 ，然後選取 外掛程式專案
- 按一下左上角的「選單」圖示 >記錄。記錄檔探索工具會隨即開啟。
如果是外掛程式錯誤記錄，請在查詢建立工具中輸入 以下查詢：
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"如要查看近期錯誤，請按一下「執行查詢」。也可以查看發生錯誤時 按一下「串流記錄」。外掛程式錯誤記錄檔會顯示在 「查詢結果」窗格。
如要進一步瞭解 Cloud 記錄檔探索工具與寫入查詢，請參閱 包括：
啟用或停用錯誤記錄功能
錯誤記錄功能預設為啟用。啟用錯誤記錄功能後， 資訊清單檔案 具備下列條件：
"exceptionLogging": "STACKDRIVER",
如要停用錯誤記錄功能，請將
將 "exceptionLogging": "STACKDRIVER", 替換為以下程式碼的
資訊清單檔案：
// Disable error logging
"exceptionLogging": "NONE"
如要重新啟用錯誤記錄功能，請將 "exceptionLogging": "NONE" 替換成
"exceptionLogging": "STACKDRIVER",。
注意事項
處理 Cloud 記錄檔中的外掛程式錯誤記錄檔 注意：
- 外掛程式只會記錄記錄檔探索工具中的錯誤。其他記錄類型為 。
- 錯誤訊息一律以英文撰寫。
- Cloud Logging 會產生費用。進一步瞭解 Cloud Logging 定價，請參閱 Google Cloud Observability 定價。