您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊
您可以透過「調查」資訊主頁,查看所有 API 流量的指標和屬性資料透視表,並比較指標之間的關聯活動,更快調查和診斷問題。你可以在資訊主頁存取過去 30 天的資料。
在 Edge UI 中依序選取「Analyze」>「API Monitoring」>「Instigate」,開啟 Investivate 資訊主頁。資訊主頁分成兩個主要區域:
您也可以在調查資訊主頁調查特定快訊造成的問題。收到快訊時,請在「快訊記錄」頁面中按一下快訊名稱,在「調查」資訊主頁中開啟快訊。
使用調查資訊主頁診斷問題
舉例來說,您會收到一則快訊,指出 5xx 錯誤率超過指定門檻。如要調查這項問題,您可以在調查資訊主頁執行下列工作:
- 查看錯誤碼與時間矩陣,瞭解過去 1 小時內的錯誤程式碼活動。
- 切換至錯誤代碼與 HTTP 狀態矩陣,找出與上述故障代碼相關聯的 HTTP 狀態碼 (如上個步驟所示),該錯誤代碼的數量在過去一小時內增加。
- 切換至錯誤程式碼與 Proxy 矩陣,找出會觸發上一個步驟中發現錯誤碼的 API Proxy。
- 在矩陣中,找出與含有大量錯誤代碼的 API Proxy 相關聯的方塊,即可查看更多詳細資料和存取記錄。
- 設定快訊並建立自訂報表,進一步協助診斷問題。
使用追蹤記錄和其他工具進一步troubleshoot,找出問題解決方法。
使用狀態碼資訊主頁
透過「狀態碼」資訊主頁,您可以查看貴機構的 API Proxy 和目標服務的狀態碼指標。您可以查看過去 30 天內的 1 小時或 4 小時期間的狀態碼指標。
探索狀態碼資訊主頁
如要顯示「狀態代碼」資訊主頁,請在 Edge UI 中依序選取「Analyze」>「API Monitoring」>「Invetigate」。根據預設,「狀態碼」資訊主頁會顯示:
如圖中所示,調查資訊主頁可讓您:
- 設定各矩陣,只要設定 x 軸和 Y 軸,即可比較指標間的關聯活動,並取得更多深入分析資料。
- 根據區塊的色彩陰影,快速找出相對音量最大的指標。區塊越深,相對音量越大。
- 按一下矩陣中的區塊,即可查看指標詳細資料。
- 依據以下項目篩選資料:
- 環境
- 區域
- Proxy
- 狀態碼 (包括所有流量、所有錯誤、2xx、4xx 或 5xx)
- 過去 30 天的日期和時間
- 1 小時或 4 小時回溯期
資訊主頁可用於快速執行下列工作:
- 指標詳細資料面板中的存取記錄檔。
- 在「近期」或「時間軸」或資訊主頁中點選 >「最近查看」>或「在時間軸上查看」>,即可查看目前背景資訊。
- 建立自訂報表,然後按一下 新增其他維度。
- 建立快訊,然後新增其他快訊條件、設定通知,以及根據快訊產生自訂報表。
設定狀態碼矩陣
選取「Status Code」資訊主頁時,系統預設會顯示下列矩陣:
- 錯誤程式碼與時間
- 錯誤代碼與 HTTP 狀態
- 來源錯誤與 API Proxy 的比較
在「x」x-和「y 軸」x-下拉式清單中選取值,設定每個矩陣來比較下列任一指標:
- 錯誤代碼
- 「錯誤」政策
- 錯誤來源
- HTTP 狀態
- Proxy
- 時間
- 區域
- 目標 (Target Service 或 Service callout 政策)。如果目標是 ServiceSummary 政策,顯示的值前面會加上
sc://
。例如:sc://my.endpoint.net
)。
查看狀態碼指標詳細資料
按一下特定指標的區塊,即可查看該指標的詳細資料。
右側窗格中會顯示與可疑原因有關的詳細資料,包括:
- 環境
- 機構
- 區域
- 錯誤來源 (Proxy、目標或 Apigee 基礎架構)
詳情可能也包含:
- 錯誤政策 - 觸發執行階段錯誤的政策相關資訊,包括政策類型 (內部名稱) 和使用者定義的政策名稱。您需要在將政策附加至 API Proxy 流程時定義名稱。
- Proxy 名稱
- HTTP 狀態碼
- 錯誤代碼
如果特定指標的基數大於 1,詳細資料面板可能會包含錯誤分佈詳細資料,例如「發布依據」、「開發人員應用程式」、「嚴重錯誤發布」、「依錯誤代碼發布」、「依 HTTP 狀態發布」等。例如:
如果錯誤來源是目標,詳細資料面板會顯示不同目標的錯誤率。例如:
使用延遲時間資訊主頁
延遲時間資訊主頁會顯示貴機構中 API Proxy 和目標服務的延遲時間資訊。您可以調查過去 30 天內任何一小時的延遲時間指標。
探索延遲時間資訊主頁
如要顯示延遲時間資訊主頁,請在 Edge UI 中依序選取「Analyze」>「API Monitoring」>「Invetigate」。根據預設,系統會顯示狀態碼資訊主頁。在篩選器區域選取「延遲時間」,顯示延遲資訊主頁。
選取「延遲」資訊主頁時,系統預設會顯示下列矩陣:
- Proxy 與時間 (以毫秒為單位的最長延遲時間)
- Proxy 與總延遲時間 (以毫秒為單位的最長延遲時間)
- Proxy 與所有目標延遲時間 (以毫秒為單位的最高延遲時間)
在「Proxy」下拉式方塊中選取「目標」,即可查看目標延遲時間。
根據預設,延遲時間資訊主頁會顯示前 1 小時內總 P99 延遲時間最長的 10 個 Proxy 相關資訊。或者,使用「前 10 名」下拉式方塊選取特定 Proxy 或集合。
延遲時間資訊主頁具備狀態碼資訊主頁的所有功能,但有以下差異:
- 您只需設定總回應延遲時間的百分位數 (p50、p90、p95、p99)。
- 延遲時間指標只能選取一小時的時間範圍。
- 您無法在篩選器中為「區域」選取「任何」。您必須選取要查看的特定區域。
查看延遲時間指標詳細資料
按一下特定指標的區塊,即可查看該指標的詳細資料。
右側窗格會顯示與 Proxy 和目標 (紫色線) 相關的延遲時間詳細資料,包括:
- 總延遲時間 (Proxy 延遲時間加上目標延遲時間)
- 每個目標的延遲時間 (目標回應時間)
- 依 HTTP 狀態發布
將滑鼠遊標懸停在圖表上,即可查看詳細資訊:
「每個目標的延遲時間」圖表會根據最大延遲時間顯示前 16 個目標,每個目標只會顯示一張圖表。只要將遊標移到圖表上,或是選取下拉式清單,即可決定與各個目標對應的圖表。
查看指標詳細資料中的記錄檔
查看狀態碼或延遲時間的指標詳細資料時,按一下「查看記錄」即可查看所選指標的所有記錄檔:
系統會開啟「Traffic Logs」對話方塊,顯示最多 1000 個記錄項目。按一下記錄項目,在清單中展開其詳細資料:
您可以按照以下條件進一步篩選記錄:
- 流量來源
- 錯誤類型
- 最短回覆時間
您無法從「流量記錄」對話方塊下載記錄資料。不過,您可以建立自訂報表或下載分析資料至您自己的資料存放區 (例如 Google Cloud Storage 或 BigQuery),並執行自己的資料分析。
透過調查資訊主頁建立自訂報表
根據所選條件組合建立自訂報表。您可以在建立自訂報表後加以編輯,並視需要新增或刪除指標和維度。舉例來說,您可能會想將調查範圍縮小至特定存取權杖、開發人員應用程式或 API Proxy。詳情請參閱「Analytics (分析) 指標、維度和篩選器參考資料」一文。
詳情請參閱「建立自訂報表」一文。
若要建立自訂報表,請按照下列步驟進行:
按一下矩陣中的區塊,即可顯示更多詳細資料。
在右側窗格中,按一下 。
自訂報表頁面會顯示在新分頁中,並預先填入相關欄位。
注意:如要進一步瞭解預設自訂報表設定,請參閱「建立自訂報表」一文。
視需要編輯自訂報表。請參閱「管理自訂報表」一文。
按一下「儲存」儲存自訂報表。
根據預設,系統執行報表時會使用過去 1 小時內收集的資料,並在自訂報表資訊主頁中顯示資料。請參閱「探索自訂報表資訊主頁」一文。
在「報表」頁面上,使用 API 監控功能產生的自訂報表會採用以下格式命名:API Monitoring Investigate Generated
。
調查特定快訊
如要調查特定快訊,請在「快訊記錄」頁面選取快訊名稱。系統隨即顯示調查資訊主頁。請注意,在資訊主頁頂端含有圖表,且只包含快訊的資訊指定: