監控近期的 API 流量

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

您可以在「Recent」資訊主頁中，監控貴機構所有 API Proxy 和目標服務在過去一小時內的近期 API 流量。API 監控資料可以詳細清單或熱視圖的形式顯示。請參閱下列各節，瞭解每種檢視畫面：

使用清單檢視畫面

「清單」檢視畫面會顯示貴機構中，近期有流量的 API Proxy 和目標服務摘要資訊。

探索清單檢視畫面

如要顯示清單檢視畫面，請在 Edge UI 中依序選取「Analyze」>「API Monitoring」>「Recent」。

系統預設會顯示清單檢視畫面。如要隨時返回清單檢視畫面，請按一下「近期」資訊主頁中的 。

最近造訪的網頁

如圖中所示，清單檢視畫面可讓您：

  • 查看貴機構過去一小時內有交易記錄的所有 API Proxy 和目標服務摘要資訊。API Proxy 和目標服務會依區域和環境列出。(如要查看更廣泛的歷史記錄，請參閱「找出 API 監控資料的趨勢」一文)。
  • 快速找出有快訊的 API 代理和目標服務。(如要瞭解如何設定快訊，請參閱「設定快訊和通知」一文)。
  • 按一下清單中的 API Proxy 或目標服務名稱，即可在右側窗格查看詳細資料。

  • 根據目前的背景資訊，快速執行下列工作 (如果選項不適用於目前選取的背景資訊，則會顯示為灰色)：

    • 建立自訂報表，並新增其他維度。按一下「」。
    • 建立快訊並新增其他快訊條件、設定通知，以及根據快訊產生自訂報表。
    • 在「時間軸」或「調查」資訊主頁中查看目前的背景資訊。依序點選 「更多」選單 >「在時間軸中查看」或「在調查中查看」。

  • 在清單檢視畫面中，依名稱或網址 (例如 https://acme.com/api) 搜尋。在搜尋框中輸入完整或部分相關字串。您可以在 Proxy、目標或區域欄位中搜尋內容。

    注意：如果選取「僅限快訊」篩選器，搜尋結果只會列出有快訊的 API Proxy 或目標服務。

  • 視需要啟用或停用頁面自動重新整理功能。

  • 在清單中顯示及隱藏目標服務詳細資料。

找出有警示的 API Proxy 和目標服務

在「清單」檢視畫面中，紅色警告圖示 和紅色左側邊框線會指出哪些 API Proxy 和目標服務有快訊。

按一下「僅限快訊」，只顯示有快訊的 API Proxy 或服務目標。

僅播放快訊

如要快速查看 4xx 和 5xx 錯誤的數量摘要，以及整體錯誤率，請將滑鼠游標懸停在表格中的任何數值上。

查看 API Proxy 或目標服務的詳細資料

如要查看 API Proxy 或目標服務的詳細資料，請在清單檢視畫面中點選名稱。詳細資料會顯示在右側窗格中。

詳細檢視

點選下列分頁標籤即可查看更多資訊：

此外，您也可以使用目前的結構定義，快速執行下列工作：

注意：如果選項不適用於目前選取的內容，就會顯示為灰色。

  • 建立自訂報表，並新增其他維度。按一下「」。
  • 建立快訊並新增其他快訊條件、設定通知，以及根據快訊產生自訂報表。依序點選 「更多」選單>「建立快訊」。
  • 在「時間軸」或「調查」資訊主頁中查看目前的背景資訊。依序點選 「更多」選單 >「在時間軸中查看」或「在調查中查看」。

詳細資料

「詳細資料」分頁會快速顯示指定時間軸的交通資訊 (如上圖所示)，包括：

詳細資料 說明
總流量 交易總數。
錯誤總數 錯誤總數。
總錯誤率 導致錯誤的流量百分比 (錯誤總數/流量總數)。

注意：API 監控會將這個百分比與您設定的快訊條件進行比較。如果總錯誤率超過門檻，使用者介面就會顯示快訊指標。

平均每秒交易數 每秒平均交易次數。
總延遲時間 (P99) 以 5 分鐘的滾動視窗計算，第 99 百分位數的總回應延遲值。
注意：僅適用於 API Proxy。
目標延遲時間 (P99) 以 5 分鐘的滾動視窗計算，第 99 個百分位數的目標回應延遲值。
注意：僅適用於 API Proxy。
錯誤來源 發生 API Proxy 套件錯誤 (4xx 和 5xx) 的細目和總百分比。

「趨勢」分頁會顯示所選元件的下列圖表：

  • 4xx 和 5xx 錯誤的錯誤率
  • 流量 (TPS)
  • 總延遲時間 (毫秒)

  • 所有目標延遲時間

將滑鼠游標懸停在圖表上的不同點，即可分別顯示每個點的錯誤百分比、流量總數和延遲時間。

熱門趨勢

記錄

在「記錄」分頁中，依 4xx、5xx 或所有錯誤篩選，並依 API Proxy、目標服務 (您的服務) 或 Apigee (Apigee 基礎架構) 縮小錯誤來源範圍。

記錄

按一下錯誤即可開啟記錄對話方塊，並在清單中展開詳細資料。

記錄

使用熱視圖

熱視圖會以色塊顯示，方便您找出有快訊的環境。

  • 綠色表示未超過快訊條件門檻。
  • 紅色表示已超過快訊條件門檻，並已觸發快訊。

探索熱視圖

按一下「最近」頁面上的 ，即可顯示熱視圖，如下圖所示。

熱視圖

如上圖所示，熱視圖可讓您：

  • 快速找出有快訊的 API 代理和目標服務。(如要瞭解如何設定快訊，請參閱「設定快訊和通知」一文)。
  • 從下拉式選單選取元件，或按兩下方塊進一步下鑽，即可篩選顯示內容。您可以在「Proxy」和「目標」下拉式清單中，使用集合進行篩選。例如：
  • 按一下熱度圖中的方塊，即可在右側窗格中查看詳細資料。

  • 根據目前的背景資訊，快速執行下列工作 (如果選項不適用於目前所選的背景資訊，就會顯示為灰色)：

    • 建立自訂報表，並新增其他維度。按一下「」。
    • 建立快訊並新增其他快訊條件、設定通知，以及根據快訊產生自訂報表。依序點選 「更多」選單>「建立快訊」。
    • 在「時間軸」或「調查」資訊主頁中查看目前的背景資訊。依序點選 「更多」選單 >「在時間軸中查看」或「在調查中查看」。

  • 將「縮放依據」設為對數或線性，即可設定熱視圖的顯示比例。Linear 會根據整體流量比例調整方塊大小。舉例來說，200 個呼叫的 Proxy 是 100 個呼叫的 Proxy 的兩倍大小。

    調整熱視圖

  • 在搜尋框中輸入完整或部分相關字串，即可搜尋熱度地圖。您可以根據目前顯示的內容，在區域、環境、Proxy 或目標地圖中搜尋內容。

    注意：如果選取「僅限快訊」篩選器，搜尋結果只會列出有快訊的 API Proxy 或目標服務。

  • 視需要啟用或停用頁面自動重新整理功能。

找出有警示的 API Proxy 和目標服務

查看熱度圖時，紅色方塊會指出哪些環境、API Proxy 和目標服務有快訊。如要進一步瞭解如何設定快訊，請參閱「設定快訊和通知」。

舉例來說，下圖顯示兩個環境：

  • 測試環境的狀態為紅色，因為流量錯誤百分比已超過您為指定時間範圍設定的警報條件門檻。
  • prod 環境為綠色，因為指定時間範圍內的流量錯誤百分比未超過快訊條件門檻。

熱視圖

從下拉式清單中選取元件，即可篩選顯示內容。或者按兩下方塊，即可從環境地圖向下鑽研至 API Proxy 地圖，並從 API Proxy 地圖鑽研至該 API Proxy 的服務目標地圖，找出有快訊的 API Proxy 和目標服務。

環境 >> Proxy >> 目標

按一下「僅限快訊」，即可只顯示有快訊的環境、API Proxy 或服務目標 (視目前顯示的內容而定)。

如要返回上一層，請按一下 熱視圖箭頭。

查看環境、API Proxy 或目標服務的詳細資料

如要查看環境、API Proxy 或目標服務的詳細資料，請按一下熱視圖中的對應方塊。詳細資料會顯示在右側窗格中。

熱視圖

分頁提供的資訊與清單檢視畫面相同。如需詳細資訊，請參閱：

按一下地圖中的方塊，還會顯示過去一小時內的通話次數和錯誤率。

熱視圖工具提示

從「近期」資訊主頁建立自訂報表

根據所選條件集建立自訂報表。自訂報表建立後，您可以視需要編輯報表，新增或刪除指標和維度。舉例來說，您可能想將調查範圍縮小至特定存取權杖、開發人員應用程式或 API Proxy。詳情請參閱「數據分析指標、維度和篩選器參考資料」。

詳情請參閱「建立自訂報表」。

如要從「最近」資訊主頁建立自訂報表，請按照下列步驟操作：

  1. 在 Edge UI 中，依序點選「Analyze」>「API Monitoring」>「Recent」。

  2. 在「清單檢視」或「熱度圖」篩選條件下拉式選單中選取 API Proxy 或目標服務，即可查看更多詳細資料。 注意：如果 Proxy 和目標篩選器設為 All，就無法使用自訂報表。

  3. 按一下右下角的 建立自訂報表。

    自訂報表頁面會在新分頁中顯示，並預先填入相關欄位和預設維度和指標。根據預設，自訂報表的名稱如下：API Monitoring Recent Generated 注意：如果目前環境已有自訂報表，系統會開啟該報表。

  4. 視需要編輯自訂報表，然後按一下「儲存」。

  5. 按一下清單中的報表名稱，然後執行自訂報表。