Udostępnij za pośrednictwem


Query - Get

Wykonywanie zapytania analizy
Wykonuje zapytanie analizy dla danych

GET https://api.loganalytics.io/v1/workspaces/{workspaceId}/query?query={query}
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

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

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

Przykładowa odpowiedź

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

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

Przykładowa odpowiedź

x-ms-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5
x-ms-correlation-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5
{
  "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.