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 |
---|---|---|---|---|
app
|
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 |
Risposta di esito positivo |
|
Other Status Codes |
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. |
error |
Dettagli errore. |
error |
Codice e messaggio per un errore. |
error |
Dettagli errore. |
query |
Query di Analisi. Altre informazioni sulla sintassi delle query di Analytics |
query |
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 |
dettagli dell'errore. |
|
innererror |
Codice e messaggio per un errore. |
|
message |
string |
Messaggio di errore leggibile. |
errorResponse
Dettagli errore.
Nome | Tipo | Descrizione |
---|---|---|
error |
Codice e messaggio per un 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. |