Query - Get

Reference

Služba:: Log Analytics

Verze rozhraní API:: 2022-10-27_Preview

Provedení analytického dotazu
Spustí analytický dotaz pro data.

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
workspaceId	path	True	string	ID pracovního prostoru. Toto je ID pracovního prostoru z okna Vlastnosti na webu Azure Portal.
query	query	True	string	Dotaz Analytics. Další informace o syntaxi dotazů Analytics
timespan	query		string (duration)	Volitelný. Časový rozsah, ve kterém se má dotazovat na data. Toto je hodnota ISO8601 časového období. Tento časový rozsah se použije vedle všech, které jsou zadány ve výrazu dotazu.

Odpovědi

Name	Typ	Description
200 OK	queryResults	OK. Volání rozhraní API bylo úspěšné a výsledek dotazu Analytics je v datové části odpovědi.
Other Status Codes	errorResponse	Objekt odpovědi na chybu.

Zabezpečení

oauth2

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

cross-workspace

simple-query

cross-workspace

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:: 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"
        ]
      ]
    }
  ]
}

Definice

Name	Description
column	Sloupec tabulky.
errorDetail	Podrobnosti o chybě
errorInfo	Kód a zpráva chyby.
errorResponse	Podrobnosti o chybě
logsColumnType	Datový typ tohoto sloupce.
queryResults	Odpověď dotazu.
Render	Vizualizace dat ve formátu JSON
Statistics	Statistiky reprezentované ve formátu JSON
table	Tabulka odpovědí dotazu.

column

Objekt

Sloupec tabulky.

Name	Typ	Description
name	string	Název tohoto sloupce.
type	logsColumnType	Datový typ tohoto sloupce.

errorDetail

Objekt

Podrobnosti o chybě

Name	Typ	Description
additionalProperties	object	Další vlastnosti, které lze zadat u objektu podrobností o chybě
code	string	Kód chyby.
message	string	Chybová zpráva čitelná pro člověka
resources	string[]	Označuje prostředky, které byly zodpovědné za chybu.
target	string	Určuje, která vlastnost v požadavku je zodpovědná za chybu.
value	string	Určuje, která hodnota v cíli odpovídá za chybu.

errorInfo

Objekt

Kód a zpráva chyby.

Name	Typ	Description
additionalProperties	object	Další vlastnosti, které lze poskytnout pro objekt s informacemi o chybě
code	string	Stroj čitelný kód chyby.
details	errorDetail[]	podrobnosti o chybě.
innererror	errorInfo	Kód a zpráva chyby. Vnitřní podrobnosti o chybě, pokud existují.
message	string	Chybová zpráva čitelná pro člověka

errorResponse

Objekt

Podrobnosti o chybě

Name	Typ	Description
error	errorInfo	Kód a zpráva chyby. Podrobnosti o chybě.

logsColumnType

Výčet

Datový typ tohoto sloupce.

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

queryResults

Objekt

Odpověď dotazu.

Name	Typ	Description
error	errorInfo	Kód a zpráva chyby.
render	Render	Vizualizace dat ve formátu JSON
statistics	Statistics	Statistiky reprezentované ve formátu JSON
tables	table[]	Seznam tabulek, sloupců a řádků

Render

Objekt

Vizualizace dat ve formátu JSON

Statistics

Objekt

Statistiky reprezentované ve formátu JSON

table

Objekt

Tabulka odpovědí dotazu.

Name	Typ	Description
columns	column[]	Seznam sloupců v této tabulce
name	string	Název tabulky.
rows	object[]	Výsledné řádky z tohoto dotazu.

Sdílet prostřednictvím

Query - Get

Parametry identifikátoru URI

Odpovědi

Zabezpečení

oauth2

Rozsahy

Příklady

cross-workspace

Ukázkový požadavek

Ukázková odpověď

simple-query

Ukázkový požadavek

Ukázková odpověď

Definice

column

errorDetail

errorInfo

errorResponse

logsColumnType

queryResults

Render

Statistics

table