共用方式為

Azure 監視器 Log Analytics API 概觀

  • 發行項

Log Analytics 查詢 API 是一個 REST API，可用來查詢 Azure 監視器記錄所收集的完整資料集。 您可以使用在整個服務中使用的相同查詢語言。 使用此 API 可為資料建置新視覺效果，並擴充 Log Analytics 的功能。

Log Analytics API 驗證

必須經過驗證才能存取 Log Analytics API：

  • 若要查詢您的工作區，必須使用 Microsoft Entra 驗證。
  • 若要在不使用 Microsoft Entra 驗證的情況下快速探索 API，您可以使用 API 金鑰來查詢非生產環境中的範例資料。

工作區資料的 Microsoft Entra 驗證

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

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

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

收到權杖之後，所有流程呼叫 Log Analytics API 的程序都相同。 要求需要 Authorization: Bearer 標頭，並填入從 OAuth2 流程收到的權杖。

範例資料的 API 金鑰驗證

若要在不使用 Microsoft Entra 驗證的情況下快速探索 API，我們有包含範例資料的示範工作區可供使用。 您可以使用 API 金鑰進行驗證。

注意

使用 Microsoft Entra 驗證時，Application Insights REST API 辨識新的角色型存取控制權限最多可能需耗時 60 分鐘。 雖然權限正在傳播，但 REST API 呼叫可能會失敗，並顯示錯誤碼 403。

Log Analytics API 查詢限制

如需查詢限制的相關資訊，請參閱此網頁的查詢 API 一節。

嘗試 Log Analytics API

若要嘗試 API 而不撰寫任何程式碼，您可以使用：

  • 您偏好的用戶端，例如 Bruno 或 Insomnia，以手動使用使用者介面產生查詢。
  • 從命令列執行 cURL。 然後，使用管線將輸出傳送至 jsonlint，以取得可讀取的 JSON。

您可以使用慣用的 Azure 監視器查詢用戶端程式庫，而不直接呼叫 REST API：

每個用戶端程式庫都是 REST API 的包裝函式，可讓您從工作區擷取記錄資料。