Dela via

Query - Get

  • Referens
Tjänst:
Log Analytics
API-version:
2022-10-27_Preview

Köra en Analysfråga
Kör en Analysfråga för data

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

URI-parametrar

Name I Obligatorisk Typ Description
workspaceId
 path True

string

ID för arbetsytan. Det här är Arbetsyte-ID från bladet Egenskaper i Azure-portalen.
query
 query True

string

Analytics-frågan. Läs mer om frågesyntaxen för Analytics
timespan
 query

string (duration)

Valfritt. Tidsintervallet för att fråga efter data. Det här är ett ISO8601 tidsperiodsvärde. Det här tidsintervallet tillämpas utöver alla som anges i frågeuttrycket.

Svar

Name Typ Description
200 OK

queryResults

OKEJ. API-anropet lyckades och analytics-frågeresultatet finns i svarsnyttolasten
Other Status Codes

errorResponse

Ett felsvarsobjekt.

Säkerhet

oauth2

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

cross-workspace
simple-query

cross-workspace

Exempelbegäran

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

Exempelsvar

Statuskod:
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

Exempelbegäran

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

Exempelsvar

Statuskod:
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"
        ]
      ]
    }
  ]
}

Definitioner

Name Description
column

En tabellkolumn.
errorDetail

Felinformation.
errorInfo

Koden och meddelandet för ett fel.
errorResponse

Felinformation.
logsColumnType

Datatypen för den här kolumnen.
queryResults

Ett frågesvar.
Render

Visualiseringsdata i JSON-format.
Statistics

Statistik som representeras i JSON-format.
table

En frågesvarstabell.

column

Objekt

En tabellkolumn.

Name Typ Description
name

string

Namnet på den här kolumnen.
type

logsColumnType

Datatypen för den här kolumnen.

errorDetail

Objekt

Felinformation.

Name Typ Description
additionalProperties

object

Ytterligare egenskaper som kan anges i felinformationsobjektet
code

string

Felets kod.
message

string

Ett mänskligt läsbart felmeddelande.
resources

string[]

Anger resurser som var ansvariga för felet.
target

string

Anger vilken egenskap i begäran som ansvarar för felet.
value

string

Anger vilket värde i målet som är ansvarigt för felet.

errorInfo

Objekt

Koden och meddelandet för ett fel.

Name Typ Description
additionalProperties

object

Ytterligare egenskaper som kan anges i felinformationsobjektet
code

string

En maskinläsbar felkod.
details

errorDetail[]

felinformation.
innererror

errorInfo

Koden och meddelandet för ett fel.
Inre felinformation om de finns.
message

string

Ett mänskligt läsbart felmeddelande.

errorResponse

Objekt

Felinformation.

Name Typ Description
error

errorInfo

Koden och meddelandet för ett fel.
Felinformationen.

logsColumnType

Uppräkning

Datatypen för den här kolumnen.

Värde Description
bool
datetime
decimal
dynamic
guid
int
long
real
string
timespan

queryResults

Objekt

Ett frågesvar.

Name Typ Description
error

errorInfo

Koden och meddelandet för ett fel.
render

Render

Visualiseringsdata i JSON-format.
statistics

Statistics

Statistik som representeras i JSON-format.
tables

table[]

Listan över tabeller, kolumner och rader.

Render

Objekt

Visualiseringsdata i JSON-format.

Statistics

Objekt

Statistik som representeras i JSON-format.

table

Objekt

En frågesvarstabell.

Name Typ Description
columns

column[]

Listan över kolumner i den här tabellen.
name

string

Tabellens namn.
rows

object[]

De resulterande raderna från den här frågan.