偵錯總覽

本頁適用於 ApigeeApigee Hybrid

查看 Apigee Edge 說明文件。

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

偵錯資料收集和傳輸

Apigee 閘道節點會收集偵錯工作階段資料,並在內部快取,然後再將資料傳送至雲端的控制層。接著會將其分享至偵錯工作階段 UI,供運算子分析。

如果您使用偵錯遮罩,Apigee 會在傳送偵錯資料至控制平面之前,先在閘道節點中執行遮罩。

使用偵錯功能

如「使用偵錯功能」一文所述,請使用 UI 或 API 透過偵錯工具建立及管理偵錯工作階段。或者,您也可以下載偵錯工作階段,並在離線狀態下查看及分析這些工作階段,如「使用離線偵錯」一文所述。

Apigee 支援使用偵錯功能

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

請注意下列事項:

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

Apigee Hybrid 使用者

如果您使用的是 Apigee hybrid,請參閱以下各節。

偵錯架構

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

要求啟動偵錯工作階段的概略說明:
    1. 您可以使用 UI 或 API 發起要求,以便開始偵錯工作階段。2. 管理層會使用 Pub/Sub 模型,向執行階段層發出偵錯工作階段建立要求。3. 訂閱偵錯工作階段通知的 Synchronizer 會將建立要求傳播至訊息處理器。4. 這些 MP 會收集偵錯資料,並將資料串流傳送至資料收集 Pod。5. 立即將偵錯資料寫入 Pod 的檔案系統。6. UDCA 會輪詢 Pod 的檔案系統,尋找新的資料檔案。7. 當 UDCA 發現新資料檔案時,就會將檔案上傳至 UAP 服務。8. 接著,您就可以透過 Apigee 服務存取資料,例如 Apigee Hybrid UI 或 Apigee API。

偵錯資料會在管理單元中保留最多 24 小時。

Apigee Hybrid 需求

本節列出 Apigee 混合式使用者須知的重要資訊。

支援資料落地

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

其他需求

  • 您必須先設定 apigee-udca 服務帳戶。請參閱「指定設定值覆寫值」。
  • 所有 Synchronizer 節點的時間都應同步,並以世界標準時間為準。