Dela via


Query - Get

Köra en Analytics-fråga
Kör en Analytics-fråga för data

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

query
query True

string

Analytics-frågan. Läs mer om analytics-frågesyntaxen

timespan
query

string

duration

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

Svar

Name Typ Description
200 OK

queryResults

OK. 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

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

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

En tabellkolumn.

Name Typ Description
name

string

Namnet på den här kolumnen.

type

logsColumnType

Datatypen för den här kolumnen.

errorDetail

Felinformation.

Name Typ Description
additionalProperties

object

Ytterligare egenskaper som kan anges för felinformationsobjektet

code

string

Felkoden.

message

string

Ett felmeddelande som kan läsas av människor.

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ål" som ansvarar för felet.

errorInfo

Koden och meddelandet för ett fel.

Name Typ Description
additionalProperties

object

Ytterligare egenskaper som kan anges för felinformationsobjektet

code

string

En felkod som kan läsas av datorn.

details

errorDetail[]

felinformation.

innererror

errorInfo

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

message

string

Ett felmeddelande som kan läsas av människor.

errorResponse

Felinformation.

Name Typ Description
error

errorInfo

Koden och meddelandet för ett fel.
Felinformationen.

logsColumnType

Datatypen för den här kolumnen.

Name Typ Description
bool

string

datetime

string

decimal

string

dynamic

string

guid

string

int

string

long

string

real

string

string

string

timespan

string

queryResults

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

Visualiseringsdata i JSON-format.

Statistics

Statistik som representeras i JSON-format.

table

En frågesvarstabell.

Name Typ Description
columns

column[]

Listan över kolumner i den här tabellen.

name

string

Namnet på tabellen.

rows

object[]

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