Query - Execute

Riferimento

Service:: Log Analytics

API Version:: 2022-10-27_Preview

Eseguire una query di Analisi
Esegue una query di Analisi per i dati. Ecco un esempio per l'uso di POST con una query di Analisi.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
workspaceId	path	True	string	ID dell'area di lavoro. Questo è l'ID area di lavoro dal pannello Proprietà nel portale di Azure.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Prefer		string	facoltativo. Intestazione preferita per impostare timeout del server, statistiche di query e informazioni di visualizzazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
query	True	string	Query da eseguire.
timespan		string	facoltativo. Intervallo di tempo su cui eseguire query sui dati. Si tratta di un valore ISO8601 periodo di tempo. Questo intervallo di tempo viene applicato oltre a qualsiasi oggetto specificato nell'espressione di query.
workspaces		string[]	Elenco di aree di lavoro incluse nella query.

Risposte

Nome	Tipo	Descrizione
200 OK	queryResults	OK. La chiamata API ha avuto esito positivo e il risultato della query di Analisi si trova nel payload della risposta
Other Status Codes	errorResponse	Oggetto risposta di errore.

Sicurezza

oauth2

Flusso OAuth2 di Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

cross-workspace

simple-query

cross-workspace

Sample Request

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

Sample Response

Status code:: 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

Sample Request

HTTP

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

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

Sample Response

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

Definizioni

Nome	Descrizione
column	Colonna tabella.
errorDetail	Dettagli degli errori.
errorInfo	Codice e messaggio per un errore.
errorResponse	Dettagli degli errori.
logsColumnType	Tipo di dati di questa colonna.
queryBody	Query di Analisi. Altre informazioni sulla sintassi della query di Analytics
queryResults	Risposta di query.
Render	Dati di visualizzazione in formato JSON.
Statistics	Statistiche rappresentate in formato JSON.
table	Tabella di risposta della query.

column

Colonna tabella.

Nome	Tipo	Descrizione
name	string	Nome di questa colonna.
type	logsColumnType	Tipo di dati di questa colonna.

errorDetail

Dettagli degli errori.

Nome	Tipo	Descrizione
additionalProperties	object	Proprietà aggiuntive che possono essere fornite nell'oggetto dettagli errore
code	string	Codice dell'errore.
message	string	Messaggio di errore leggibile.
resources	string[]	Indica le risorse responsabili dell'errore.
target	string	Indica quale proprietà nella richiesta è responsabile dell'errore.
value	string	Indica quale valore in "target" è responsabile dell'errore.

errorInfo

Codice e messaggio per un errore.

Nome	Tipo	Descrizione
additionalProperties	object	Proprietà aggiuntive che possono essere fornite nell'oggetto informazioni sugli errori
code	string	Codice di errore leggibile dal computer.
details	errorDetail[]	dettagli dell'errore.
innererror	errorInfo	Codice e messaggio per un errore. Dettagli dell'errore interno se esistenti.
message	string	Messaggio di errore leggibile.

errorResponse

Dettagli degli errori.

Nome	Tipo	Descrizione
error	errorInfo	Codice e messaggio per un errore. Dettagli dell'errore.

logsColumnType

Tipo di dati di questa colonna.

Nome	Tipo	Descrizione
bool	string
datetime	string
decimal	string
dynamic	string
guid	string
int	string
long	string
real	string
string	string
timespan	string

queryBody

Query di Analisi. Altre informazioni sulla sintassi della query di Analytics

Nome	Tipo	Descrizione
query	string	Query da eseguire.
timespan	string	facoltativo. Intervallo di tempo su cui eseguire query sui dati. Si tratta di un valore ISO8601 periodo di tempo. Questo intervallo di tempo viene applicato oltre a qualsiasi oggetto specificato nell'espressione di query.
workspaces	string[]	Elenco di aree di lavoro incluse nella query.

queryResults

Risposta di query.

Nome	Tipo	Descrizione
error	errorInfo	Codice e messaggio per un errore.
render	Render	Dati di visualizzazione in formato JSON.
statistics	Statistics	Statistiche rappresentate in formato JSON.
tables	table[]	Elenco di tabelle, colonne e righe.

Render

Dati di visualizzazione in formato JSON.

Statistics

Statistiche rappresentate in formato JSON.

table

Tabella di risposta della query.

Nome	Tipo	Descrizione
columns	column[]	Elenco di colonne in questa tabella.
name	string	Nome della tabella.
rows	object[]	Righe risultanti da questa query.

Query - Execute

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Risposte

Sicurezza

oauth2

Scopes

Esempio

cross-workspace

Sample Request

Sample Response

simple-query

Sample Request

Sample Response

Definizioni

column

errorDetail

errorInfo

errorResponse

logsColumnType

queryBody

queryResults

Render

Statistics

table

Risorse aggiuntive