本指南說明如何在 Google Cloud 記錄檔探索工具中查詢 Chat 應用程式錯誤記錄。查詢記錄以:
- 瞭解使用者是否會發生錯誤。
- 瞭解錯誤發生頻率及最常見的錯誤。
- 閱讀描述性的錯誤訊息和記錄資料,瞭解如何修正錯誤。
必備條件
- 擁有可存取 Google Chat 的 Google Workspace 帳戶。
- Chat 應用程式。如要建構 Chat 應用程式,請按照quickstart操作。
- 為 Chat 應用程式啟用錯誤記錄功能。
查詢錯誤記錄檔
在 Google Cloud 控制台中,依序按一下「選單」圖示 >「更多產品」 >「Logging」 >「記錄檔探索工具」。
如要顯示查詢產生器,請開啟「顯示查詢」。
針對 Chat 應用程式錯誤記錄,請輸入下列查詢:
severity=ERROR resource.type="chat.googleapis.com/Project"
如要查看近期錯誤,請按一下「Run query」。或者,如要查看發生的錯誤,請按一下「串流記錄」。「查詢結果」窗格中會顯示即時通訊應用程式錯誤記錄。
如要進一步瞭解 Google Cloud 記錄檔探索工具及撰寫查詢,請參閱記錄檔探索工具說明文件中的下列指南:
從記錄中讀取錯誤訊息
查詢錯誤記錄後,您可以查看個別記錄,而這些記錄是由描述記錄的 JSON 酬載組成。如果是 Chat 應用程式錯誤,JSON 會在 jsonPayload.error.message
中加入錯誤訊息。例如,在下列範例記錄中,錯誤訊息顯示 Apps Script 函式無法執行:
JSON
{
"insertId": "INSERT_ID",
"jsonPayload": {
"@type": "type.googleapis.com/google.chat.logging.v1.ChatAppLogEntry",
"error": {
"code": 9,
"message": "An Apps Script function failed to execute. To review AppsScript error logs, see \"Logging\" (https://developers.google.com/apps-script/guides/logging)."
},
"deployment": "DEPLOYMENT_ID"
},
"resource": {
"type": "chat.googleapis.com/Project",
"labels": {
"project_id": "PROJECT_ID"
}
},
"timestamp": "2022-12-06T05:24:18.697255Z",
"severity": "ERROR",
"logName": "projects/PROJECT_ID/logs/chat.googleapis.com%2Ferrors",
"receiveTimestamp": "2022-12-06T05:24:19.207936968Z"
}
注意事項
在 Google Cloud 記錄檔探索工具中處理 Chat 應用程式錯誤記錄時,請注意下列事項:
就 Google Chat 應用程式而言,記錄檔探索工具目前提供下列嚴重性的記錄,有助於排解應用程式故障問題:
ERROR
相關服務的記錄檔也有助於偵錯 Chat 應用程式。舉例來說,如果是透過 Google Cloud Functions 部署 Chat 應用程式,則檢查 Cloud Functions 記錄檔的記錄檔探索工具也是最佳做法。
錯誤訊息一律以英文撰寫。
Cloud Logging 會產生費用。如要進一步瞭解 Cloud Logging 定價,請參閱 Google Cloud 作業套件定價。
相關主題
查詢錯誤記錄後,如果發現錯誤,請參閱下列指南,瞭解如何修正錯誤:
- 瞭解如何修正 Google Chat 應用程式錯誤,例如「應用程式無回應」、「Google Chat API 僅適用於 Google Workspace 使用者」或「使用者無法從聊天室中排除」等。
- 瞭解如何修正資訊卡錯誤,例如資訊卡訊息、對話方塊或連結預覽無法正常顯示或運作。
- 瞭解如何偵錯。