偵錯總覽

本頁內容適用於 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 說明文件。

注意：如果是 Apigee Hybrid 1.13.1 版，只有啟用資料落地功能的新建 Apigee Hybrid 機構，才能使用新的資料管道。請參閱設定混合式環境以使用新的資料管道。 如果是 Hybrid 1.14 以上版本，無論是否啟用資料落地功能，所有 Hybrid 機構都會預設使用新的資料管道。

「偵錯」工具可監控在 Apigee 上執行的 API Proxy，並排解相關問題，透過偵錯工具，您可以透過 API Proxy 流程探測每個步驟的詳細資料。Apigee 可讓您收集偵錯資料，顯示 API 代理的完整要求/回應流程。這包括所有要求/回應參數，以及在政策執行期間套用至這些參數的轉換。這對 API Proxy 開發和部署期間的偵錯及疑難排解作業至關重要。

在舊版 Apigee 中，Debug 工具稱為 Trace 工具。

術語：「偵錯資料」和「偵錯工作階段資料」這兩個詞彙可互換使用。

偵錯資料收集和傳輸作業

Apigee 閘道節點會收集偵錯工作階段資料，並在內部快取這些資料，然後將資料傳輸至 Cloud 中的控制平面。接著，這些資料會分享至偵錯工作階段 UI，供運算子分析。

如果您使用「偵錯遮蓋」，Apigee 會在閘道節點中執行遮蓋作業，然後將偵錯資料傳輸至控制平面。

使用偵錯功能

如要使用使用者介面或 API 建立及管理偵錯工作階段，請參閱「使用偵錯」一文。或者，您也可以下載偵錯工作階段，然後離線查看及分析，詳情請參閱「使用離線偵錯」。

Apigee 支援使用 Debug

Only customers can trigger a debug session, but Apigee Support can access non-deleted past debug sessions during the course of a support case to help troubleshoot proxy-specific issues.

Note the following:

• Apigee Support has read-only permission to Debug data.
• Apigee Support may request that you run a debug to capture information about an issue, and that you provide the debug session ID or a link to the debug session so that Support may review the captured debug. Since saved debug sessions are valid for only 24 hours, we recommend that you download the debug session and attach it to the case opened with Support to enable offline viewing.

Apigee Hybrid 使用者

注意：如果是 Apigee Hybrid 1.13.1 以上版本，則支援為啟用資料落地功能的新建 Apigee Hybrid 機構使用偵錯工具。請參閱「使用資料存放位置設定，收集 Analytics 和偵錯資料」。

如果您使用 Apigee hybrid，請參閱下列章節。

偵錯架構

以下說明建立新偵錯工作階段的程序：

注意：由於多次輪詢具有非同步特性，因此偵錯資料不會即時提供，而是會稍微延遲。

偵錯資料最多會在管理平台保留 24 小時。

Apigee Hybrid 需求條件

本節列出 Apigee Hybrid 使用者的重要資訊。

支援資料落地設定

• 如果您已建立啟用資料落地設定的 Apigee Hybrid 1.13.1 版機構，請按照「搭配 Apigee Hybrid 使用資料落地設定」一文中的步驟操作。
• 所有同步器節點上的時鐘都應同步，並採用世界標準時間。

舊版 Apigee Hybrid 不支援資料落地。

其他需求

• 您必須設定 apigee-udca 服務帳戶。請參閱「指定設定覆寫」。
• 所有同步器節點上的時鐘都應同步，並採用世界標準時間。