Query - Get

Referensi

Layanan:: Log Analytics

Versi API:: 2022-10-27_Preview

Menjalankan kueri Analitik
Menjalankan kueri Analitik untuk data

HTTP

GET https://api.loganalytics.io/v1/workspaces/{workspaceId}/query?query={query}

Dengan parameter opsional:

HTTP

GET https://api.loganalytics.io/v1/workspaces/{workspaceId}/query?query={query}&timespan={timespan}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
workspaceId	path	True	string	ID ruang kerja. Ini adalah ID Ruang Kerja dari bilah Properti di portal Azure.
query	query	True	string	Kueri Analitik. Pelajari selengkapnya tentang sintaks kueri Analytics
timespan	query		string duration	Opsional. Rentang waktu untuk mengkueri data. Ini adalah nilai periode waktu ISO8601. Rentang waktu ini diterapkan selain yang ditentukan dalam ekspresi kueri.

Respons

Nama	Jenis	Deskripsi
200 OK	queryResults	OK. Panggilan API berhasil dan hasil kueri Analytics berada dalam payload respons
Other Status Codes	errorResponse	Objek respons kesalahan.

Keamanan

oauth2

Alur OAuth2 Azure Active Directory

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

cross-workspace

simple-query

cross-workspace

Permintaan sampel

HTTP

HTTP

GET https://api.loganalytics.io/v1/workspaces/63613592-b6f7-4c3d-a390-22ba13102111/query?query=union * | where TimeGenerated > ago(1h) | summarize count() by Type, TenantId

Respon sampel

Kode status:: 200

JSON

{
  "tables": [
    {
      "name": "PrimaryResult",
      "columns": [
        {
          "name": "Type",
          "type": "string"
        },
        {
          "name": "TenantId",
          "type": "string"
        },
        {
          "name": "count_",
          "type": "long"
        }
      ],
      "rows": [
        [
          "Usage",
          "63613592-b6f7-4c3d-a390-22ba13102111",
          "1"
        ],
        [
          "Usage",
          "d436f322-a9f4-4aad-9a7d-271fbf66001c",
          "1"
        ],
        [
          "BillingFact",
          "63613592-b6f7-4c3d-a390-22ba13102111",
          "1"
        ],
        [
          "BillingFact",
          "d436f322-a9f4-4aad-9a7d-271fbf66001c",
          "1"
        ],
        [
          "Operation",
          "63613592-b6f7-4c3d-a390-22ba13102111",
          "7"
        ],
        [
          "Operation",
          "d436f322-a9f4-4aad-9a7d-271fbf66001c",
          "5"
        ]
      ]
    }
  ]
}

simple-query

Permintaan sampel

HTTP

HTTP

GET https://api.loganalytics.io/v1/workspaces/63613592-b6f7-4c3d-a390-22ba13102111/query?query=Usage | take 10&timespan=PT12H

Respon sampel

Kode status:: 200

HTTP

x-ms-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5
x-ms-correlation-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5

JSON

{
  "tables": [
    {
      "name": "PrimaryResult",
      "columns": [
        {
          "name": "TenantId",
          "type": "string"
        },
        {
          "name": "Computer",
          "type": "string"
        },
        {
          "name": "TimeGenerated",
          "type": "datetime"
        },
        {
          "name": "SourceSystem",
          "type": "string"
        },
        {
          "name": "StartTime",
          "type": "datetime"
        },
        {
          "name": "EndTime",
          "type": "datetime"
        },
        {
          "name": "ResourceUri",
          "type": "string"
        },
        {
          "name": "LinkedResourceUri",
          "type": "string"
        },
        {
          "name": "DataType",
          "type": "string"
        },
        {
          "name": "Solution",
          "type": "string"
        },
        {
          "name": "BatchesWithinSla",
          "type": "long"
        },
        {
          "name": "BatchesOutsideSla",
          "type": "long"
        },
        {
          "name": "BatchesCapped",
          "type": "long"
        },
        {
          "name": "TotalBatches",
          "type": "long"
        },
        {
          "name": "AvgLatencyInSeconds",
          "type": "real"
        },
        {
          "name": "Quantity",
          "type": "real"
        },
        {
          "name": "QuantityUnit",
          "type": "string"
        },
        {
          "name": "IsBillable",
          "type": "bool"
        },
        {
          "name": "MeterId",
          "type": "string"
        },
        {
          "name": "LinkedMeterId",
          "type": "string"
        },
        {
          "name": "Type",
          "type": "string"
        }
      ],
      "rows": [
        [
          "b438b4f6-912a-46d5-9cb1-b44069212abc",
          "ContosoSQLSrv1",
          "2017-08-24T06:59:59Z",
          "OMS",
          "2017-08-24T06:00:00Z",
          "2017-08-24T06:59:59Z",
          "/subscriptions/e4272367-5645-4c4e-9c67-3b74b59a6982/resourcegroups/contosoazurehq/providers/microsoft.operationalinsights/workspaces/contosoretail-it",
          null,
          "Perf",
          "LogManagement",
          "1",
          "0",
          "0",
          "1",
          "1.286",
          "0.076408",
          "MBytes",
          "true",
          "a4e29a95-5b4c-408b-80e3-113f9410566e",
          "00000000-0000-0000-0000-000000000000",
          "Usage"
        ],
        [
          "b438b4f6-912a-46d5-9cb1-b44069212abc",
          "Store010Web3",
          "2017-08-24T06:59:59Z",
          "OMS",
          "2017-08-24T06:00:00Z",
          "2017-08-24T06:59:59Z",
          "/subscriptions/e4272367-5645-4c4e-9c67-3b74b59a6982/resourcegroups/contosoazurehq/providers/microsoft.operationalinsights/workspaces/contosoretail-it",
          null,
          "Perf",
          "LogManagement",
          "1",
          "0",
          "0",
          "1",
          "1.7",
          "0.106767",
          "MBytes",
          "true",
          "a4e29a95-5b4c-408b-80e3-113f9410566e",
          "00000000-0000-0000-0000-000000000000",
          "Usage"
        ]
      ]
    }
  ]
}

Definisi

Nama	Deskripsi
column	Kolom tabel.
errorDetail	Detail kesalahan.
errorInfo	Kode dan pesan untuk kesalahan.
errorResponse	Detail kesalahan.
logsColumnType	Jenis data kolom ini.
queryResults	Respons kueri.
Render	Data visualisasi dalam format JSON.
Statistics	Statistik yang diwakili dalam format JSON.
table	Tabel respons kueri.

column

Kolom tabel.

Nama	Jenis	Deskripsi
name	string	Nama kolom ini.
type	logsColumnType	Jenis data kolom ini.

errorDetail

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalProperties	object	Properti tambahan yang dapat disediakan pada objek detail kesalahan
code	string	Kode kesalahan.
message	string	Pesan kesalahan yang dapat dibaca manusia.
resources	string[]	Menunjukkan sumber daya yang bertanggung jawab atas kesalahan tersebut.
target	string	Menunjukkan properti mana dalam permintaan yang bertanggung jawab atas kesalahan tersebut.
value	string	Menunjukkan nilai mana dalam 'target' yang bertanggung jawab atas kesalahan tersebut.

errorInfo

Kode dan pesan untuk kesalahan.

Nama	Jenis	Deskripsi
additionalProperties	object	Properti tambahan yang dapat disediakan pada objek info kesalahan
code	string	Kode kesalahan yang dapat dibaca mesin.
details	errorDetail[]	detail kesalahan.
innererror	errorInfo	Kode dan pesan untuk kesalahan. Detail kesalahan dalam jika ada.
message	string	Pesan kesalahan yang dapat dibaca manusia.

errorResponse

Detail kesalahan.

Nama	Jenis	Deskripsi
error	errorInfo	Kode dan pesan untuk kesalahan. Detail kesalahan.

logsColumnType

Jenis data kolom ini.

Nama	Jenis	Deskripsi
bool	string
datetime	string
decimal	string
dynamic	string
guid	string
int	string
long	string
real	string
string	string
timespan	string

queryResults

Respons kueri.

Nama	Jenis	Deskripsi
error	errorInfo	Kode dan pesan untuk kesalahan.
render	Render	Data visualisasi dalam format JSON.
statistics	Statistics	Statistik yang diwakili dalam format JSON.
tables	table[]	Daftar tabel, kolom, dan baris.

Render

Data visualisasi dalam format JSON.

Statistics

Statistik yang diwakili dalam format JSON.

table

Tabel respons kueri.

Nama	Jenis	Deskripsi
columns	column[]	Daftar kolom dalam tabel ini.
name	string	Nama tabel.
rows	object[]	Baris yang dihasilkan dari kueri ini.

Bagikan melalui

Query - Get

Parameter URI

Respons

Keamanan

oauth2

Cakupan

Contoh

cross-workspace

Permintaan sampel

Respon sampel

simple-query

Permintaan sampel

Respon sampel

Definisi

column

errorDetail

errorInfo

errorResponse

logsColumnType

queryResults

Render

Statistics

table

Sumber Daya Tambahan: