調查問題

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

您可以透過「調查」資訊主頁,查看所有 API 流量的指標和屬性資料透視表,並比較指標之間的關聯活動,更快調查和診斷問題。你可以在資訊主頁存取過去 30 天的資料。

在 Edge UI 中依序選取「Analyze」>「API Monitoring」>「Instigate」,開啟 Investivate 資訊主頁。資訊主頁分成兩個主要區域:

  • 狀態碼可讓您調查 API Proxy 和目標服務的狀態碼指標。
  • 延遲可讓您調查 API Proxy 和目標服務的延遲問題。

您也可以在調查資訊主頁調查特定快訊造成的問題。收到快訊時,請在「快訊記錄」頁面中按一下快訊名稱,在「調查」資訊主頁中開啟快訊。

使用調查資訊主頁診斷問題

舉例來說,您會收到一則快訊,指出 5xx 錯誤率超過指定門檻。如要調查這項問題,您可以在調查資訊主頁執行下列工作:

  1. 查看錯誤碼與時間矩陣,瞭解過去 1 小時內的錯誤程式碼活動。
  2. 切換至錯誤代碼與 HTTP 狀態矩陣,找出與上述故障代碼相關聯的 HTTP 狀態碼 (如上個步驟所示),該錯誤代碼的數量在過去一小時內增加。
  3. 切換至錯誤程式碼與 Proxy 矩陣,找出會觸發上一個步驟中發現錯誤碼的 API Proxy。
  4. 在矩陣中,找出與含有大量錯誤代碼的 API Proxy 相關聯的方塊,即可查看更多詳細資料和存取記錄。
  5. 設定快訊建立自訂報表,進一步協助診斷問題。
  6. 使用追蹤記錄和其他工具進一步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. 按一下矩陣中的區塊,即可顯示更多詳細資料。

    選取區塊

  2. 在右側窗格中,按一下 建立自訂報表

    建立報表

    自訂報表頁面會顯示在新分頁中,並預先填入相關欄位。

    注意:如要進一步瞭解預設自訂報表設定,請參閱「建立自訂報表」一文。

    編輯報表

  3. 視需要編輯自訂報表。請參閱「管理自訂報表」一文。

  4. 按一下「儲存」儲存自訂報表。

根據預設,系統執行報表時會使用過去 1 小時內收集的資料,並在自訂報表資訊主頁中顯示資料。請參閱「探索自訂報表資訊主頁」一文。

在「報表」頁面上,使用 API 監控功能產生的自訂報表會採用以下格式命名:API Monitoring Investigate Generated

調查特定快訊

如要調查特定快訊,請在「快訊記錄」頁面選取快訊名稱。系統隨即顯示調查資訊主頁。請注意,在資訊主頁頂端含有圖表,且只包含快訊的資訊指定:

調查快訊頁面

  • 查看快訊觸發時的 API 流量詳細資料。
  • 查看快訊的相關資訊,包括在圖表中央觸發快訊的時間。
  • 按一下「條件詳細資料」,即可在彈出式視窗中顯示快訊條件的詳細資料。
  • 按一下「教戰手冊」(如果有的話) 即可查看快訊的教戰手冊

    應對手冊連結

  • 按一下「管理快訊」即可編輯快訊

  • 按一下「查看報表」 (如有) 即可查看自訂報表

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