Query - Get

Referentie

Service:: Log Analytics

API-versie:: 2022-10-27_Preview

Een analysequery uitvoeren
Hiermee wordt een Analytics-query voor gegevens uitgevoerd

GET https://api.loganalytics.io/v1/workspaces/{workspaceId}/query?query={query}

Met optionele parameters:

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

URI-parameters

Name	In	Vereist	Type	Description
workspaceId	path	True	string	Id van de werkruimte. Dit is de werkruimte-id op de blade Eigenschappen in Azure Portal.
query	query	True	string	De analytics-query. Meer informatie over de Analytics-querysyntaxis
timespan	query		string (duration)	Facultatief. De periode waarin gegevens moeten worden opgeslagen. Dit is een ISO8601 tijdsperiodewaarde. Deze periode wordt toegepast naast de tijdsperioden die zijn opgegeven in de query-expressie.

Antwoorden

Name	Type	Description
200 OK	queryResults	OK. De API-aanroep is geslaagd en het resultaat van de Analytics-query bevindt zich in de nettolading van het antwoord
Other Status Codes	errorResponse	Een foutantwoordobject.

Beveiliging

oauth2

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

cross-workspace

simple-query

cross-workspace

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

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

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

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

Definities

Name	Description
column	Een tabelkolom.
errorDetail	Foutdetails.
errorInfo	De code en het bericht voor een fout.
errorResponse	Foutdetails.
logsColumnType	Het gegevenstype van deze kolom.
queryResults	Een queryantwoord.
Render	Visualisatiegegevens in JSON-indeling.
Statistics	Statistieken die worden weergegeven in JSON-indeling.
table	Een antwoordtabel voor query's.

column

Object

Een tabelkolom.

Name	Type	Description
name	string	De naam van deze kolom.
type	logsColumnType	Het gegevenstype van deze kolom.

errorDetail

Object

Foutdetails.

Name	Type	Description
additionalProperties	object	Aanvullende eigenschappen die kunnen worden opgegeven in het object foutdetails
code	string	De code van de fout.
message	string	Een door mensen leesbaar foutbericht.
resources	string[]	Geeft resources aan die verantwoordelijk zijn voor de fout.
target	string	Geeft aan welke eigenschap in de aanvraag verantwoordelijk is voor de fout.
value	string	Geeft aan welke waarde in 'doel' verantwoordelijk is voor de fout.

errorInfo

Object

De code en het bericht voor een fout.

Name	Type	Description
additionalProperties	object	Aanvullende eigenschappen die kunnen worden opgegeven in het object foutinformatie
code	string	Een door de machine leesbare foutcode.
details	errorDetail[]	foutdetails.
innererror	errorInfo	De code en het bericht voor een fout. Interne foutdetails als deze bestaan.
message	string	Een door mensen leesbaar foutbericht.

errorResponse

Object

Foutdetails.

Name	Type	Description
error	errorInfo	De code en het bericht voor een fout. De foutdetails.

logsColumnType

Inventarisatie

Het gegevenstype van deze kolom.

Waarde	Description
bool
datetime
decimal
dynamic
guid
int
long
real
string
timespan

queryResults

Object

Een queryantwoord.

Name	Type	Description
error	errorInfo	De code en het bericht voor een fout.
render	Render	Visualisatiegegevens in JSON-indeling.
statistics	Statistics	Statistieken die worden weergegeven in JSON-indeling.
tables	table[]	De lijst met tabellen, kolommen en rijen.

Render

Object

Visualisatiegegevens in JSON-indeling.

Statistics

Object

Statistieken die worden weergegeven in JSON-indeling.

table

Object

Een antwoordtabel voor query's.

Name	Type	Description
columns	column[]	De lijst met kolommen in deze tabel.
name	string	De naam van de tabel.
rows	object[]	De resulterende rijen uit deze query.

Delen via

Query - Get

URI-parameters

Antwoorden

Beveiliging

oauth2

Bereiken

Voorbeelden

cross-workspace

Voorbeeldaanvraag

Voorbeeldrespons

simple-query

Voorbeeldaanvraag

Voorbeeldrespons

Definities

column

errorDetail

errorInfo

errorResponse

logsColumnType

queryResults

Render

Statistics

table

Aanvullende resources