Query - Execute
Executar uma consulta do Analytics
Executa uma consulta de Análise para dados.
Eis um exemplo para utilizar POST com uma consulta de Análise.
POST https://api.applicationinsights.io/v1/apps/{appId}/query
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
app
|
path | True |
string |
ID da aplicação. Este é o ID da Aplicação no painel definições de Acesso à API no portal do Azure. |
Corpo do Pedido
Name | Necessário | Tipo | Description |
---|---|---|---|
query | True |
string |
A consulta a executar. |
applications |
string[] |
Uma lista de IDs da Aplicação para consultas entre aplicações. |
|
timespan |
string |
Opcional. O período de tempo sobre o qual consultar dados. Este é um valor ISO8601 período de tempo. Este período de tempo é aplicado para além dos especificados na expressão de consulta. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
Resposta com êxito |
|
Other Status Codes |
Um objeto de resposta de erro. |
Segurança
oauth2
Ligar à API do Aplicação Azure Insights
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io
Âmbitos
Name | Description |
---|---|
user_impersonation | representar a sua conta de utilizador |
Exemplos
queryPost
Pedido de amostra
POST https://api.applicationinsights.io/v1/apps/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/query
{
"timespan": "PT12H",
"query": "requests | summarize count() by bin(timestamp, 1h)"
}
Resposta da amostra
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"
]
]
}
]
}
Definições
Name | Description |
---|---|
column |
Uma coluna de tabela. |
error |
Detalhes do erro. |
error |
O código e a mensagem de um erro. |
error |
Detalhes do erro. |
query |
A consulta Análise. Saiba mais sobre a sintaxe de consulta do Analytics |
query |
Uma resposta de consulta. |
table |
Uma tabela de resposta de consulta. |
column
Uma coluna de tabela.
Name | Tipo | Description |
---|---|---|
name |
string |
O nome desta coluna. |
type |
string |
O tipo de dados desta coluna. |
errorDetail
Detalhes do erro.
Name | Tipo | Description |
---|---|---|
additionalProperties |
object |
|
code |
string |
O código do erro. |
message |
string |
Uma mensagem de erro legível por humanos. |
resources |
string[] |
Indica os recursos responsáveis pelo erro. |
target |
string |
Indica que propriedade no pedido é responsável pelo erro. |
value |
string |
Indica que valor em "destino" é responsável pelo erro. |
errorInfo
O código e a mensagem de um erro.
Name | Tipo | Description |
---|---|---|
additionalProperties |
object |
|
code |
string |
Um código de erro legível por computador. |
details |
detalhes do erro. |
|
innererror |
O código e a mensagem de um erro. |
|
message |
string |
Uma mensagem de erro legível por humanos. |
errorResponse
Detalhes do erro.
Name | Tipo | Description |
---|---|---|
error |
O código e a mensagem de um erro. |
queryBody
A consulta Análise. Saiba mais sobre a sintaxe de consulta do Analytics
Name | Tipo | Description |
---|---|---|
applications |
string[] |
Uma lista de IDs da Aplicação para consultas entre aplicações. |
query |
string |
A consulta a executar. |
timespan |
string |
Opcional. O período de tempo sobre o qual consultar dados. Este é um valor ISO8601 período de tempo. Este período de tempo é aplicado para além dos especificados na expressão de consulta. |
queryResults
Uma resposta de consulta.
Name | Tipo | Description |
---|---|---|
tables |
table[] |
A lista de tabelas, colunas e linhas. |
table
Uma tabela de resposta de consulta.
Name | Tipo | Description |
---|---|---|
columns |
column[] |
A lista de colunas nesta tabela. |
name |
string |
O nome da tabela. |
rows |
string[] |
As linhas resultantes desta consulta. |