Query - Execute

Odwołanie

Usługa:: Log Analytics

Wersja interfejsu API:: 2022-10-27_Preview

Wykonywanie zapytania analizy
Wykonuje zapytanie analizy dla danych. Oto przykład użycia żądania POST z zapytaniem analizy.

POST https://api.loganalytics.io/v1/workspaces/{workspaceId}/query

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.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
Prefer		string	Opcjonalny. Preferuj nagłówek ustawiania limitu czasu serwera, statystyk zapytań i informacji wizualizacji.

Treść żądania

Nazwa	Wymagane	Typ	Opis
query	True	string	Zapytanie do wykonania.
timespan		string	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.
workspaces		string[]	Lista obszarów roboczych uwzględnionych w zapytaniu.

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

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

cross-workspace

simple-query

cross-workspace

Przykładowe żądanie

HTTP

POST https://api.loganalytics.io/v1/workspaces/63613592-b6f7-4c3d-a390-22ba13102111/query

{
  "query": "union * | where TimeGenerated > ago(1h) | summarize count() by Type, TenantId",
  "workspaces": [
    "draft-test",
    "draft-test-2"
  ]
}

Przykładowa odpowiedź

Kod stanu:: 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

Przykładowe żądanie

HTTP

POST https://api.loganalytics.io/v1/workspaces/63613592-b6f7-4c3d-a390-22ba13102111/query

{
  "query": "Usage | take 10",
  "timespan": "PT12H"
}

Przykładowa odpowiedź

Kod stanu:: 200

{
  "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.
queryBody	Zapytanie Analizy. Dowiedz się więcej o składni zapytań analizy
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

queryBody

Zapytanie Analizy. Dowiedz się więcej o składni zapytań analizy

Nazwa	Typ	Opis
query	string	Zapytanie do wykonania.
timespan	string	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.
workspaces	string[]	Lista obszarów roboczych uwzględnionych w zapytaniu.

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.

Udostępnij za pośrednictwem

Query - Execute

Parametry identyfikatora URI

Nagłówek żądania

Treść żądania

Odpowiedzi

Zabezpieczenia

oauth2

Zakresy

Przykłady

cross-workspace

Przykładowe żądanie

Przykładowa odpowiedź

simple-query

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

column

errorDetail

errorInfo

errorResponse

logsColumnType

queryBody

queryResults

Render

Statistics

table

Dodatkowe zasoby