Azure 監視器 Log Analytics API 概觀

Log Analytics 查詢 API 是 REST API,可用來查詢 Azure 監視器記錄所收集的完整數據集。 您可以使用在整個服務中使用的相同查詢語言。 使用此 API 來擷取數據、建置數據的新視覺效果,以及擴充 Log Analytics 的功能。

Log Analytics API 驗證

您必須驗證才能存取 Log Analytics API:

  • 若要查詢工作區,您必須使用 Microsoft Entra 驗證
  • 若要快速探索 API 而不使用 Microsoft Entra 驗證,您可以使用 API 金鑰來查詢非生產環境中的範例數據。

工作區數據的 Microsoft Entra 驗證

Log Analytics API 支援使用三種不同的 Microsoft Entra ID OAuth2 流程進行 Microsoft Entra 驗證:

  • 授權碼
  • 隱式
  • 用戶端認證

授權碼流程和隱含流程都需要至少一個使用者互動式登入您的應用程式。 如果您需要非互動式流程,請使用客戶端認證流程。

收到令牌之後,所有流程呼叫 Log Analytics API 的程式都相同。 要求需要 Authorization: Bearer 標頭,並填入從 OAuth2 流程收到的令牌。

範例數據的 API 金鑰驗證

為了快速探索 API 而不使用 Microsoft Entra 驗證,我們提供示範工作區與範例數據。 您可以使用 API 金鑰進行驗證。

注意

當您使用 Microsoft Entra 驗證時,Application Insights REST API 最多可能需要 60 分鐘的時間才能辨識新的角色型訪問控制許可權。 雖然許可權正在傳播,但 REST API 呼叫可能會失敗,錯誤 碼 403

Log Analytics API 查詢限制

如需查詢限制的相關信息,請參閱 此網頁的查詢 API 一節。

嘗試Log Analytics API

若要嘗試 API 而不撰寫任何程式代碼,您可以使用:

您可以使用慣用的 Azure 監視器查詢用戶端連結庫,而不是直接呼叫 REST API:

每個用戶端連結庫都是 REST API 的包裝函式,可讓您從工作區擷取記錄數據。