偵錯總覽

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

查看 Apigee Edge 說明文件。

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

偵錯資料收集和傳輸作業

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

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

使用偵錯功能

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

Apigee 支援團隊使用偵錯功能

只有客戶可以觸發偵錯工作階段，但 Apigee 支援團隊可以在支援案件期間存取未刪除的過去偵錯工作階段，協助排解代理伺服器相關問題。

請注意下列事項：

  • Apigee 支援團隊對偵錯資料有唯讀權限。
  • Apigee 支援團隊可能會要求您執行偵錯作業，擷取問題相關資訊，並提供偵錯工作階段 ID 或偵錯工作階段連結，方便支援團隊查看擷取的偵錯資訊。由於儲存的偵錯工作階段只會在 24 小時內有效，建議您下載偵錯工作階段，並附加至向支援團隊開啟的案件，以便離線查看。

Apigee Hybrid 使用者

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

偵錯架構

以下說明如何建立新的偵錯工作階段：

啟動偵錯工作階段的要求概觀： 1. 使用 UI 或 API 啟動偵錯工作階段要求。 2. 管理平面會使用發布/訂閱模型，向執行階段平面發出偵錯工作階段建立要求。 3. 訂閱偵錯工作階段通知的 Synchronizer 會將建立要求傳播至 Message Processor。4. MP 會收集偵錯資料，並將資料串流傳輸至資料收集 Pod。 5. fluentd 會立即將偵錯資料寫入 Pod 的檔案系統。 6. UDCA 會輪詢 Pod 的檔案系統，尋找新的資料檔案。7. UDCA 找到新的資料檔案時，會將檔案上傳至 UAP 服務。 8. 接著，您就能透過 Apigee 服務 (例如 Apigee Hybrid UI 或 Apigee API) 存取資料。

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

Apigee Hybrid 需求條件

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

支援資料落地

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

其他需求

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