取得 Azure API 管理中的 API 分析
適用於:開發人員 |基本 |基本 v2 |標準 |標準 v2 |Premium |進階 v2
Azure API 管理會為您的 API 提供分析,讓您可以分析其使用量和效能。 使用分析進行 API 的高階監視和疑難排解。 如需其他監視功能 (包括診斷和稽核的近乎即時計量和資源記錄),請參閱教學課程:監視已發佈的 API。
注意
目前,此功能無法在工作區中使用。
關於 API 分析
API 管理會使用以 Azure 監視器為基礎的儀表板來提供分析。 儀表板會彙總 Azure Log Analytics 工作區中的資料。
在傳統 API 管理服務層級中,您的 API 管理執行個體也包含 Azure 入口網站中的舊版內建分析,而且可以使用 API 管理 REST API 來存取分析資料。 以 Azure 監視器為基礎的儀表板和內建分析中會顯示極為類似的資料。
重要
- 以 Azure 監視器為基礎的儀表板是存取分析資料的建議方式。
- v2 層未提供內建 (傳統) 分析。
使用 API 分析,分析跨數個維度的 API 管理執行個體中的 API 使用量和效能,包括:
- Time
- 地理位置
- API
- API 作業
- 產品
- 訂用帳戶
- 使用者
- 要求
注意
- API 分析提供有關要求的資料,包括失敗和未經授權的要求。
- 地理位置值是根據 IP 位址對應的近似值。
- 分析數據的可用性可能會延遲。
以 Azure 監視器為基礎的儀表板
若要使用以 Azure 監視器為基礎的儀表板,您需要 Log Analytics 工作區作為 APIM 閘道記錄的資料來源。
如果您需要設定一個,以下是將閘道記錄傳送至 Log Analytics 工作區的簡短步驟。 如需詳細資訊,請參閱教學課程:監視已發佈的 API。 此設定只需要執行一次。
- 在 Azure 入口網站中,瀏覽至您的 API 管理執行個體。
- 在左側功能表的 [監視] 底下,選取 [診斷設定] > [+ 新增診斷設定]。
- 輸入診斷設定的描述性名稱。
- 在 [記錄] 中,選取 [與 ApiManagement 閘道相關的記錄]。
- 在 [目的地詳細資料] 中,選取 [傳送至 Log Analytics],然後選取相同或不同訂用帳戶中的 Log Analytics 工作區。 如果您需要建立工作區,請參閱建立 Log Analytics 工作區。
- 請確保已選取 [資源特定] 作為目的地資料表。
- 選取儲存。
重要
新的 Log Analytics 工作區最多可能需要 2 小時才能開始接收數據。 現有的工作區應該會在大約 15 分鐘內開始接收數據。
存取儀表板
設定 Log Analytics 工作區之後,請存取以 Azure 監視器為基礎的儀表板,以分析 API 的使用量和效能。
- 在 Azure 入口網站中,瀏覽至您的 API 管理執行個體。
- 在左側功能表的 [監視] 下,選取 [分析]。 分析儀表板隨即開啟。
- 選取資料的時間範圍。
- 選取分析資料的報表類別,例如 [時間表]、[地理位置] 等等。
舊版內建分析
在某些 APIM 服務層級中,Azure 入口網站中也提供內建分析 (也稱為舊版分析或傳統分析),而且可以使用 API 管理 REST API 來存取分析資料。
內建分析 - 入口網站
若要存取 Azure 入口網站中的內建 (傳統) 分析:
- 在 Azure 入口網站中,瀏覽至您的 API 管理執行個體。
- 在左側功能表的 [監視] 下,選取 [分析 (傳統)]。
- 選取資料的時間範圍,或輸入自訂時間範圍。
- 選取分析資料的報表類別,例如 [時間表]、[地理位置] 等等。
- 可選擇依一或多個其他類別來篩選報表。
分析 - REST API
使用 API 管理 REST API 中的報表作業,以擷取和篩選 API 管理執行個體的分析資料。
可用的作業會依 API、地理位置、API 作業、產品、要求、訂用帳戶、時間或使用者來傳回報表記錄。
相關內容
- 如需 API 管理中 Azure 監視器功能的簡介,請參閱教學課程:監視已發佈的 API
- 如需詳細的 HTTP 記錄和監視,請參閱使用 Azure API 管理、事件中樞和 Moesif 來監視 API。
- 了解如何整合 Azure API 管理與 Azure Application Insights。
- 了解內建 API 分析儀表板淘汰 (2027 年 3 月)