Condividi tramite


Query - Get

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

GET https://api.loganalytics.io/v1/workspaces/{workspaceId}/query?query={query}
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

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

{
  "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

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.