Query - Get

Riferimento

Servizio:: Log Analytics

Versione API:: 2022-10-27_Preview

Eseguire una query di Analisi
Esegue una query di Analisi per i dati

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
workspaceId	path	True	string	ID dell'area di lavoro. Si tratta dell'ID area di lavoro nel pannello Proprietà del portale di Azure.
query	query	True	string	Query di Analisi. Altre informazioni sulla sintassi delle query di Analytics
timespan	query		string duration	facoltativo. Intervallo di tempo in cui eseguire query sui dati. Si tratta di un valore ISO8601 periodo di tempo. Questo intervallo di tempo viene applicato oltre a qualsiasi specificato nell'espressione di query.

Risposte

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

Sicurezza

oauth2

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

cross-workspace

simple-query

cross-workspace

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 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"
        ]
      ]
    }
  ]
}

Definizioni

Nome	Descrizione
column	Colonna di tabella.
errorDetail	Dettagli errore.
errorInfo	Codice e messaggio per un errore.
errorResponse	Dettagli errore.
logsColumnType	Tipo di dati di questa colonna.
queryResults	Risposta di query.
Render	Dati di visualizzazione in formato JSON.
Statistics	Statistiche rappresentate in formato JSON.
table	Una tabella di risposta alla query.

column

Colonna di tabella.

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

errorDetail

Dettagli errore.

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 il 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 errore.

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

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

Una tabella di risposta alla query.

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

Condividi tramite

Query - Get

Parametri dell'URI

Risposte

Sicurezza

oauth2

Ambiti

Esempio

cross-workspace

Esempio di richiesta

Risposta di esempio

simple-query

Esempio di richiesta

Risposta di esempio

Definizioni

column

errorDetail

errorInfo

errorResponse

logsColumnType

queryResults

Render

Statistics

table

Risorse aggiuntive