查詢 Google Workspace 外掛程式的錯誤記錄

如果發布的 Google Workspace 外掛程式傳回錯誤， 外掛程式介面會傳回一般訊息 「執行外掛程式時發生錯誤。」不過，這些錯誤 Cloud 記錄檔探索工具。

本指南說明如何在 透過 Cloud 記錄檔探索工具，您可以：

  • 瞭解使用者是否會發生錯誤。
  • 瞭解錯誤發生的頻率，以及錯誤發生頻率。
  • 閱讀描述性的錯誤訊息，瞭解如何修正問題。

必要條件

查詢外掛程式錯誤記錄檔之前：

  • 啟用「Cloud Logging API」外掛程式 存取 Google Cloud ������如要啟用 API，請參閱 建立 Cloud 專案並啟用 API。
  • 在 Google Workspace Marketplace 發布外掛程式。 如要在 市集，請參閱 發布應用程式。

查詢外掛程式錯誤記錄檔

如要取得外掛程式的記錄：

  1. 開啟 Google Cloud 控制台。
  2. 在「Google Cloud Platform」旁邊按一下向下箭頭 ，然後選取 外掛程式專案
  3. 按一下左上角的「選單」圖示 >記錄。記錄檔探索工具會隨即開啟。

  4. 如果是外掛程式錯誤記錄，請在查詢建立工具中輸入 以下查詢：

    severity>=ERROR
protoPayload.serviceName="gsuiteaddons.googleapis.com"

  5. 如要查看近期錯誤，請按一下「執行查詢」。也可以查看發生錯誤時 按一下「串流記錄」。外掛程式錯誤記錄檔會顯示在 「查詢結果」窗格。

如要進一步瞭解 Cloud 記錄檔探索工具與寫入查詢，請參閱 包括：

啟用或停用錯誤記錄功能

錯誤記錄功能預設為啟用。啟用錯誤記錄功能後， 資訊清單檔案 具備下列條件：

"exceptionLogging": "STACKDRIVER",

如要停用錯誤記錄功能，請將 將 "exceptionLogging": "STACKDRIVER", 替換為以下程式碼的 資訊清單檔案：

// Disable error logging
"exceptionLogging": "NONE"

如要重新啟用錯誤記錄功能，請將 "exceptionLogging": "NONE" 替換成 "exceptionLogging": "STACKDRIVER",。

注意事項

處理 Cloud 記錄檔中的外掛程式錯誤記錄檔 注意：

  • 外掛程式只會記錄記錄檔探索工具中的錯誤。其他記錄類型為 。
  • 錯誤訊息一律以英文撰寫。
  • Cloud Logging 會產生費用。進一步瞭解 Cloud Logging 定價，請參閱 Google Cloud Observability 定價。