Condividi tramite


Query - Execute

Eseguire una query di Analisi
Esegue una query di Analisi per i dati. Di seguito è riportato un esempio per l'uso di POST con una query di Analisi.

POST https://api.applicationinsights.io/v1/apps/{appId}/query

Parametri dell'URI

Nome In Necessario Tipo Descrizione
appId
path True

string

ID dell'applicazione. Si tratta dell'ID applicazione del pannello Impostazioni accesso API nel portale di Azure.

Corpo della richiesta

Nome Necessario Tipo Descrizione
query True

string

Query da eseguire.

applications

string[]

Elenco di ID applicazione per le query tra applicazioni.

timespan

string

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

Risposta di esito positivo

Other Status Codes

errorResponse

Oggetto risposta di errore.

Sicurezza

oauth2

Connettersi all'API di applicazione Azure Insights

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

queryPost

Esempio di richiesta

POST https://api.applicationinsights.io/v1/apps/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/query

{
  "timespan": "PT12H",
  "query": "requests | summarize count() by bin(timestamp, 1h)"
}

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": "timestamp",
          "type": "datetime"
        },
        {
          "name": "count_",
          "type": "long"
        }
      ],
      "rows": [
        [
          "2018-02-02T05:00:00Z",
          "255"
        ],
        [
          "2018-02-01T17:00:00Z",
          "148"
        ],
        [
          "2018-02-01T18:00:00Z",
          "453"
        ],
        [
          "2018-02-01T19:00:00Z",
          "404"
        ],
        [
          "2018-02-01T20:00:00Z",
          "403"
        ],
        [
          "2018-02-01T21:00:00Z",
          "405"
        ],
        [
          "2018-02-01T22:00:00Z",
          "438"
        ],
        [
          "2018-02-01T23:00:00Z",
          "403"
        ],
        [
          "2018-02-02T00:00:00Z",
          "423"
        ],
        [
          "2018-02-02T01:00:00Z",
          "403"
        ],
        [
          "2018-02-02T02:00:00Z",
          "425"
        ],
        [
          "2018-02-02T03:00:00Z",
          "437"
        ],
        [
          "2018-02-02T04:00:00Z",
          "420"
        ]
      ]
    }
  ]
}

Definizioni

Nome Descrizione
column

Colonna di tabella.

errorDetail

Dettagli errore.

errorInfo

Codice e messaggio per un errore.

errorResponse

Dettagli errore.

queryBody

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

queryResults

Risposta di query.

table

Una tabella di risposta alla query.

column

Colonna di tabella.

Nome Tipo Descrizione
name

string

Nome della colonna.

type

string

Tipo di dati di questa colonna.

errorDetail

Dettagli errore.

Nome Tipo Descrizione
additionalProperties

object

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

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.

queryBody

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

Nome Tipo Descrizione
applications

string[]

Elenco di ID applicazione per le query tra applicazioni.

query

string

Query da eseguire.

timespan

string

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.

queryResults

Risposta di query.

Nome Tipo Descrizione
tables

table[]

Elenco di tabelle, colonne e righe.

table

Una tabella di risposta alla query.

Nome Tipo Descrizione
columns

column[]

Elenco di colonne in questa tabella.

name

string

Nome della tabella.

rows

string[]

Righe risultanti da questa query.