本頁適用於 Apigee 和 Apigee Hybrid。
查看
Apigee Edge 說明文件。
Apigee API Monitoring、Apigee API Analytics 和 Apigee 存取記錄是三項強大的工具,可用於收集、觀察及瞭解 API 用量資料。每個工具都提供不同的洞察資料,建議您根據用途選用。本文將簡要介紹各項工具的用途和建議用法,請參閱以下各節:
API Monitoring
API 監控功能的目標是提供 API 效能即時洞察資料,讓您能快速診斷及修正問題,確保 API 正常運作。
API 監控功能會每分鐘提供 API Proxy 的匯總資料,讓您密切監控 API 的健康狀態和效能。您可以使用 API 監控功能,針對指定參數設定近乎即時的快訊,並在排解問題時利用匯總資料。
透過 API 監控功能,您可以:
- 維持 API 可用性。
- 在消費者受到影響前採取行動。
- 使用 Apigee 錯誤代碼加快診斷問題的速度。
- 快速找出問題區域,診斷效能和延遲問題的來源。
Apigee 客戶也可以使用 Cloud Monitoring 工具支援 API Monitoring。如要整合其他監控系統,建議您使用 Monitoring API 來擷取指標。
使用 API 監控功能時的延遲時間資料
由於 API 監控功能是為了擴大規模而有意設計,因此不會記錄每次交易中的個別延遲測量值。而是使用分佈區塊來測量延遲時間。延遲時間區間會使用預先定義的範圍,將觀察到的延遲時間值分組。
如要進一步瞭解如何使用 API Monitoring 監控 API,請參閱「API Monitoring 總覽」。
如要進一步瞭解如何搭配使用 Monitoring 和 Apigee 設定快訊,請參閱「設定快訊和通知」。
Apigee API 數據分析
Apigee API Analytics 可針對 API 呼叫中繼資料提供歷來趨勢分析和詳細報表。Apigee Analytics 的目標是協助您瞭解 API 流量的長期趨勢,確保 API 可滿足業務需求,或視需要進行變更。
透過 Apigee API Analytics,您可以從約 50 個可用維度中選擇,指定要為 Proxy 處理的每個 API 呼叫擷取哪些資料。接著,您可以建立自訂報表,瞭解特定 API 指標的變化趨勢。
擷取的數據分析資料會儲存在 BigQuery 中。您可以使用 Apigee API Analytics 在 Looker Studio 中建立自訂報表、設定非同步自訂報表工作,或將數據分析資料匯出至您自己的 Google Cloud 儲存庫 (例如 BigQuery)。如果您採用預付費方案,API Analytics 是可選的加購項目。
以下是您可以使用 Apigee Analytics 找出的一些趨勢:
- 長期來看,您的 API 流量有什麼變化?
- 您最常使用的應用程式
- 您的主要開發人員是誰?
- API 回應時間最快或最慢的時間為何?
- 哪些地理區域的 API 流量最多?
使用 Apigee API Analytics 時的延遲資料
Apigee API Analytics 觀察到延遲時間,會使用 BigQuery 儲存的個別記錄,對近似分位數匯總函式進行匯總。與 API 監控中使用的分桶邏輯相比,這可讓延遲時間的結果資料更精確。API 監控和 Apigee API Analytics 中的延遲時間都是從 Apigee 執行階段開始計算,不包含先前網路中繼 (包括 Istio) 的延遲時間計算。
如要進一步瞭解 Apigee API Analytics,請參閱「Apigee API Analytics 總覽」。
Apigee 存取記錄
Apigee 存取記錄可用於排解對 Apigee 的 API 呼叫問題,並找出哪些 API 傳回特定的 HTTP 回應代碼。
Apigee 存取記錄會在 Apigee 入口閘道擷取每筆交易的記錄。這麼一來,您就能根據特定 HTTP 代碼篩選記錄,並輕鬆排解特殊情況,例如 Istio 上的回應狀態碼為 0
。
如要進一步瞭解如何使用 Apigee 存取記錄來排解 API 問題,請參閱「Apigee 存取記錄」。
API 監控資料和 Analytics 顯示的資料差異
API 監控和 Apigee API 數據分析會使用不同的管道存取 API 資料。因此,Apigee API Analytics 資訊主頁顯示的資料,可能會與 API 監控功能提供的資料有些出入。
準確性和時效性
一般來說,Apigee API Analytics 顯示的資料較為準確,但與 API 監控顯示的資料相比,可能會稍微延遲 (小於 1 小時)。
資料保留
Apigee API Analytics 保留的資料時間比 API Monitoring 長,因此更適合用於分析長期趨勢。
Analytics 和 API 監控的資料保留期限如下:
數據分析
- 標準:60 天
- Enterprise:90 天
- Enterprise +:14 個月
API Monitoring:1 個月