Sdílet prostřednictvím

Formát požadavku rozhraní LOG Analytics API služby Azure Monitor

  • Článek

Existují dva koncové body, pomocí kterých můžete komunikovat s rozhraním Log Analytics API:

  • Přímá adresa URL pro rozhraní API: https://api.loganalytics.azure.com
  • Prostřednictvím Azure Resource Manageru (ARM).

I když se adresy URL liší, parametry dotazu jsou pro každý koncový bod stejné. Oba koncové body vyžadují autorizaci prostřednictvím ID Microsoft Entra.

Rozhraní API podporuje metody POST a GET metody.

Formát veřejného rozhraní API

Formát veřejného rozhraní API je:

    https://api.loganalytics.azure.com/{api-version}/workspaces/{workspaceId}/query?[parameters]

kde:

  • api-version: Verze rozhraní API. Aktuální verze je v1.
  • workspaceId: ID vašeho pracovního prostoru
  • parameters: Data požadovaná pro tento dotaz

GET /query

Při spuštění GETmetody HTTP jsou parametry zahrnuty do řetězce dotazu.

Pokud chcete například spočítat události AzureActivity podle kategorie, proveďte toto volání:

    GET https://api.loganalytics.azure.com/v1/workspaces/{workspace-id}/query?query=AzureActivity%20|%20summarize%20count()%20by%20Category
    Authorization: Bearer <access token>

POST /query

Při spuštění metody HTTP je POST:

  • Text musí být platný ve formátu JSON.
  • Požadavek musí obsahovat hlavičku: Content-Type: application/json
  • Parametry jsou zahrnuty jako vlastnosti v textu JSON.
  • Pokud je parametr časového rozsahu součástí řetězce dotazu i textu JSON, bude časový rozsah průsečíkem dvou hodnot.

Pokud chcete například spočítat události AzureActivity podle kategorie, proveďte toto volání:

    POST https://api.loganalytics.azure.com/v1/workspaces/{workspace-id}/query
    
    Authorization: Bearer <access token>
    Content-Type: application/json
    
    {
      "query": "AzureActivity | summarize count() by Category"
    }