使用 Trace 查看訊息資料

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件
資訊

課程內容

透過本教學課程,您可以瞭解下列主題:

  • 查看回應訊息的標頭和內文內容。
  • 查看錯誤訊息。

軟硬體需求

  • Proxy 中有至少一個政策 (也是「開始使用」教學課程的一部分)。
  • 機器安裝 curl,以便透過指令列發出 API 呼叫。

查看訊息資料

API Proxy 追蹤工具可讓您查看標頭、變數、物件和其他詳細資料,例如 API Proxy 要求和回應流程中的回應時間。Trace 工具也可以讓您查看要求或回應在 API Proxy 處理期間的變化。

先前的教學課程中,您是透過 SpikeArrest 政策限制要求數量。現在,您就可以使用追蹤記錄工具,查看特定頻率超出上限時值得注意的詳細資料。

  1. 在 API Proxy 的「Develop」(開發) 分頁中,將 Spike Arrest 政策的 <Rate> 再次編輯為下午 1 點,然後按一下 [Save] Proxy。讓我們可以看到成功和失敗 (超出限制) API 呼叫的結果。
  2. 在 API Proxy 編輯器中,按一下「Trace」分頁標籤

  3. 按一下「Start Trace Session」

  4. 使用 curl (或網路瀏覽器中的網址) 再次呼叫 API Proxy,直到 Trace 的「交易」窗格內顯示至少一項 200 回應和一則 429 回應為止。

    curl "http://org_name-test.apigee.net/getstarted"

  5. 按一下「Stop Trace Session」

  6. 在左側的「交易」窗格中按一下 200 交易。其追蹤記錄詳細資料會載入「交易地圖」下方的主視窗中,並顯示要求/回應圖表。「尖峰移動」圖示正在要求流程中。
  7. 在流程圖中,按一下回應中的圓形圖示,最右邊的圖示 (如下圖所示)。

    「階段詳細資料」窗格會顯示流程中該時間點的可用資料。如果捲動瀏覽該窗格,您會看到 HTTP 回應標頭和主體內容。

  8. 現在,請查看 Trace 中的錯誤。

    在「交易」窗格中按一下 429 交易。在主要編輯器視窗中,您看到的流程圖只會顯示要求中的項目,例如以紅色驚嘆號顯示的紅色驚嘆號圖示。

    請按一下「尖峰力逮捕」圖示右側的小管狀錯誤圖示,然後在「Phase Details」(階段詳細資料) 窗格中查看尖峰時段的逮捕違規詳細資料。

    刺釘逮捕錯誤

您可以按一下流程圖中的「Back」和「Next」按鈕,在流程中的各點之間移動,以及查看 Trace 詳細資料。

如要將整個 Trace 視為單一文件,請點選「Download Trace Session」下載,

詳情請參閱「使用 Trace 工具」。