Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
動作疑難排解
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
如果動作專案失敗或運作效能不佳,問題原因可能並不明顯。您可以透過動作主控台 查看專案的詳細記錄,進一步掌握實際情況。
查看專案的記錄檔
您可以透過 Analytics (分析) 下方的「Actions Console」存取專案記錄檔:
在專案「Actions 主控台」 中,選取頂端選單中的「Analytics」(分析) 。
選取靠近頁面頂端的「Health」 分頁標籤。
在「錯誤」 下方,選取右上角的「查看記錄檔」 連結:
這個連結會將您導向 Google Cloud Platform 中的專案記錄檔,您可以在其中篩選、展開及分析已收集的記錄資料。
注意: Actions on Google 專案的記錄檔是透過 Stackdriver Logging 產生,您可以運用這項工具管理記錄檔和數據分析。如要進一步瞭解如何瀏覽專案的記錄檔,請參閱 Stackdriver 說明文件中的查看記錄 。請注意,這些說明文件所述的所有篩選器目前都不適用於 Actions on Google 專案。 如果您使用動作模擬器 測試動作,可以按一下「Actions Emulator」頁面右上角的「View Logs」 連結,快速存取測試專屬的記錄。
疑難排解
記錄項目會以表示緊急程度的等級標示。如果是對動作專案的問題進行疑難排解,建議您先篩選「嚴重」 、「錯誤」 和「警告」 事件:
每個記錄項目都有摘要,其中包含事件的時間戳記和簡短說明。您可以將專案行為與這些記錄時間戳記建立關聯,藉此判斷兩者是否相關,然後參考說明來縮小原因範圍。
在以下範例中,系統傳回 UnparseableJsonResponse 錯誤,原因可能是從 Webhook 接收這個 JSON 回應時,出現語法或逾時錯誤的結果:
建議您也尋找時間戳記相近的「Debug 」事件,因為這類事件可能包含其他事件的額外資訊。展開錯誤記錄並依 trace 欄位篩選後,結果清單會顯示與初始錯誤相關聯的所有事件:
注意: 如果產生的追蹤記錄篩選器並未顯示初始記錄以外的任何其他結果,請檢查篩選器中是否有「嚴重程度」 行,然後嘗試將其移除。 在以下範例中,與原始錯誤相關的偵錯訊息會提供問題的詳細資訊,包括詳細的錯誤說明和造成問題的特定 JSON 回應:
停用記錄類型
由於專案記錄是全方位的,因此根據預設,排除特定事件類型 (例如含有 PII 的事件或您認為雜亂的事件) 建議您排除特定事件類型。如要在專案的記錄檔頁面中建立排除,請前往左側導覽列的「Resource usage」 ,然後選取「Excludes」 分頁標籤:
如要進一步瞭解如何排除不同的記錄事件,請參閱 Stackdriver 說明文件的排除記錄 。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權 ,程式碼範例則為阿帕契 2.0 授權 。詳情請參閱《Google Developers 網站政策 》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-07-26 (世界標準時間)。"],[],[]]