Share via

Format permintaan Azure Monitor Log Analytics API

  • Artikel

Ada dua titik akhir yang dapat Anda gunakan untuk berkomunikasi dengan Log Analytics API:

  • URL langsung untuk API: https://api.loganalytics.azure.com
  • Melalui Azure Resource Manager (ARM).

Meskipun URL berbeda, parameter kuerinya sama untuk setiap titik akhir. Kedua titik akhir memerlukan otorisasi melalui ID Microsoft Entra.

API mendukung metode POST dan GET.

Format API Publik

Format API Publik adalah:

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

di mana:

  • api-version: Versi API. Versi saat ini adalah "v1"
  • workspaceId: ID ruang kerja Anda
  • parameter: Data yang diperlukan untuk kueri ini

GET/kueri

Ketika metode HTTP yang dijalankan adalah GET, parameternya disertakan dalam string kueri.

Misalnya, untuk menghitung peristiwa AzureActivity menurut Kategori, lakukan panggilan ini:

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

POST/kueri

Saat metode HTTP dijalankan adalah POST:

  • Isi HARUS merupakan JSON yang valid.
  • Permintaan harus menyertakan header: Content-Type: application/json
  • Parameter disertakan sebagai properti dalam isi JSON.
  • Jika parameter timespan disertakan dalam string kueri dan isi JSON, rentang waktu akan menjadi persimpangan dari dua nilai.

Misalnya, untuk menghitung peristiwa AzureActivity menurut Kategori, lakukan panggilan ini:

    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"
    }