Udostępnij za pośrednictwem

Query - Get

  • Odwołanie
Usługa:
Log Analytics
Wersja interfejsu API:
2022-10-27_Preview

Wykonywanie zapytania analizy
Wykonuje zapytanie analizy dla danych

GET https://api.loganalytics.io/v1/workspaces/{workspaceId}/query?query={query}
Z parametrami opcjonalnymi: 
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 witrynie Azure Portal.
query
 query True

string

Zapytanie analizy. Dowiedz się więcej o składni zapytań usługi Analytics
timespan
 query

string (duration)

Opcjonalny. Przedział czasu, w którym ma być wykonywać zapytania dotyczące danych. Jest to wartość okresu ISO8601. Ten przedział czasu jest stosowany oprócz wszystkich określonych 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 protokołu 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ź

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

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

Przykładowa odpowiedź

Kod stanu:
200 
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 o błędzie.
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

Objekt

Kolumna tabeli.

Nazwa Typ Opis
name

string

Nazwa tej kolumny.
type

logsColumnType

Typ danych tej kolumny.

errorDetail

Objekt

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 docelowym jest odpowiedzialna za błąd.

errorInfo

Objekt

Kod i komunikat o błędzie.

Nazwa Typ Opis
additionalProperties

object

Dodatkowe właściwości, które można podać w obiekcie 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 o błędzie.
Szczegóły błędu wewnętrznego, jeśli istnieją.
message

string

Czytelny dla człowieka komunikat o błędzie.

errorResponse

Objekt

Szczegóły błędu.

Nazwa Typ Opis
error

errorInfo

Kod i komunikat o błędzie.
Szczegóły błędu.

logsColumnType

Wyliczanie

Typ danych tej kolumny.

Wartość Opis
bool
datetime
decimal
dynamic
guid
int
long
real
string
timespan

queryResults

Objekt

Odpowiedź na zapytanie.

Nazwa Typ Opis
error

errorInfo

Kod i komunikat o błędzie.
render

Render

Dane wizualizacji w formacie JSON.
statistics

Statistics

Statystyki reprezentowane w formacie JSON.
tables

table[]

Lista tabel, kolumn i wierszy.

Render

Objekt

Dane wizualizacji w formacie JSON.

Statistics

Objekt

Statystyki reprezentowane w formacie JSON.

table

Objekt

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.