Query - Get

Service:

Log Analytics

API Version:

2022-10-27_Preview

Wykonywanie zapytania analizy
Wykonuje zapytanie analizy dla danych

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

With optional parameters:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
workspaceId	path	True	string	Identyfikator obszaru roboczego. Jest to identyfikator obszaru roboczego z bloku Właściwości w Azure Portal.
query	query	True	string	Zapytanie Analizy. Dowiedz się więcej o składni zapytań analizy
timespan	query		string duration	Opcjonalny. Przedział czasu, przez który ma być odpytytywanie danych. Jest to wartość okresu ISO8601. Ten przedział czasu jest stosowany oprócz każdego określonego w wyrażeniu zapytania.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	queryResults	OK. Wywołanie interfejsu API powiodło się, a wynik zapytania analizy znajduje się w ładunku odpowiedzi
Other Status Codes	errorResponse	Obiekt odpowiedzi o błędzie.

Zabezpieczenia

oauth2

Przepływ OAuth2 usługi Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

cross-workspace

simple-query

cross-workspace

Sample Request

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

Sample Response

Status code:

200

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

Sample Request

HTTP

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

Sample Response

Status code:

200

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

Response Body

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

Definicje

Nazwa	Opis
column	Kolumna tabeli.
errorDetail	Szczegóły błędu.
errorInfo	Kod i komunikat dotyczący błędu.
errorResponse	Szczegóły błędu.
logsColumnType	Typ danych tej kolumny.
queryResults	Odpowiedź na zapytanie.
Render	Dane wizualizacji w formacie JSON.
Statistics	Statystyki reprezentowane w formacie JSON.
table	Tabela odpowiedzi na zapytanie.

column

Kolumna tabeli.

Nazwa	Typ	Opis
name	string	Nazwa tej kolumny.
type	logsColumnType	Typ danych tej kolumny.

errorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalProperties	object	Dodatkowe właściwości, które można podać w obiekcie szczegółów błędu
code	string	Kod błędu.
message	string	Czytelny dla człowieka komunikat o błędzie.
resources	string[]	Wskazuje zasoby, które były odpowiedzialne za błąd.
target	string	Wskazuje, która właściwość w żądaniu jest odpowiedzialna za błąd.
value	string	Wskazuje, która wartość w elemecie "target" jest odpowiedzialna za błąd.

errorInfo

Kod i komunikat dotyczący błędu.

Nazwa	Typ	Opis
additionalProperties	object	Dodatkowe właściwości, które można podać dla obiektu informacji o błędzie
code	string	Kod błędu z możliwością odczytu maszyny.
details	errorDetail[]	szczegóły błędu.
innererror	errorInfo	Kod i komunikat dotyczący błędu. Szczegóły błędu wewnętrznego, jeśli istnieją.
message	string	Czytelny dla człowieka komunikat o błędzie.

errorResponse

Szczegóły błędu.

Nazwa	Typ	Opis
error	errorInfo	Kod i komunikat dotyczący błędu. Szczegóły błędu.

logsColumnType

Typ danych tej kolumny.

Nazwa	Typ	Opis
bool	string
datetime	string
decimal	string
dynamic	string
guid	string
int	string
long	string
real	string
string	string
timespan	string

queryResults

Odpowiedź na zapytanie.

Nazwa	Typ	Opis
error	errorInfo	Kod i komunikat dotyczący błędu.
render	Render	Dane wizualizacji w formacie JSON.
statistics	Statistics	Statystyki reprezentowane w formacie JSON.
tables	table[]	Lista tabel, kolumn i wierszy.

Render

Dane wizualizacji w formacie JSON.

Statistics

Statystyki reprezentowane w formacie JSON.

table

Tabela odpowiedzi na zapytanie.

Nazwa	Typ	Opis
columns	column[]	Lista kolumn w tej tabeli.
name	string	Nazwa tabeli.
rows	object[]	Wynikowe wiersze z tego zapytania.