Query - Execute

Referens

Tjänst:: Log Analytics

API-version:: 2022-10-27_Preview

Köra en Analytics-fråga
Kör en Analytics-fråga för data. Här är ett exempel på hur du använder POST med en Analytics-fråga.

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

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.

Begärandehuvud

Name	Obligatorisk	Typ	Description
Prefer		string	Valfritt. Föredrar huvudet för att ange servertidsgräns, frågestatistik och visualiseringsinformation.

Begärandetext

Name	Obligatorisk	Typ	Description
query	True	string	Frågan som ska köras.
timespan		string	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.
workspaces		string[]	En lista över arbetsytor som ingår i frågan.

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

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

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

HTTP

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

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

Exempelsvar

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

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.
queryBody	Analytics-frågan. Läs mer om analytics-frågesyntaxen
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

queryBody

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

Name	Typ	Description
query	string	Frågan som ska köras.
timespan	string	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.
workspaces	string[]	En lista över arbetsytor som ingår i frågan.

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.

Dela via

Query - Execute

URI-parametrar

Begärandehuvud

Begärandetext

Svar

Säkerhet

oauth2

Omfattningar

Exempel

cross-workspace

Exempelbegäran

Exempelsvar

simple-query

Exempelbegäran

Exempelsvar

Definitioner

column

errorDetail

errorInfo

errorResponse

logsColumnType

queryBody

queryResults

Render

Statistics

table

Ytterligare resurser