Condividi tramite

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à nel portale di Azure.
query
 query True

string

Query di Analisi. Altre informazioni sulla sintassi delle query di Analytics
timespan
 query

string (duration)

Opzionale. 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 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

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

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

Tabella di risposta di query.

column

Object

Colonna di tabella.

Nome Tipo Descrizione
name

string

Nome della colonna.
type

logsColumnType

Tipo di dati di questa colonna.

errorDetail

Object

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

Object

Codice e messaggio per un errore.

Nome Tipo Descrizione
additionalProperties

object

Proprietà aggiuntive che possono essere fornite nell'oggetto informazioni sull'errore
code

string

Codice di errore leggibile del computer.
details

errorDetail[]

dettagli dell'errore.
innererror

errorInfo

Codice e messaggio per un errore.
Dettagli dell'errore interno, se presenti.
message

string

Messaggio di errore leggibile.

errorResponse

Object

Dettagli errore.

Nome Tipo Descrizione
error

errorInfo

Codice e messaggio per un errore.
Dettagli dell'errore.

logsColumnType

Enumerazione

Tipo di dati di questa colonna.

Valore Descrizione
bool
datetime
decimal
dynamic
guid
int
long
real
string
timespan

queryResults

Object

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

Object

Dati di visualizzazione in formato JSON.

Statistics

Object

Statistiche rappresentate in formato JSON.

table

Object

Tabella di risposta di query.

Nome Tipo Descrizione
columns

column[]

Elenco di colonne in questa tabella.
name

string

Nome della tabella.
rows

object[]

Righe risultanti da questa query.