Query - Execute
Executar uma consulta do Analytics
Executa uma consulta do Analytics para dados.
Aqui está um exemplo para usar POST com uma consulta de Análise.
POST https://api.applicationinsights.io/v1/apps/{appId}/query
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
app
|
path | True |
string |
ID do aplicativo. Essa é a ID do Aplicativo na folha Configurações de acesso à API no portal do Azure. |
Corpo da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
query | True |
string |
A consulta a ser executada. |
applications |
string[] |
Uma lista de IDs de aplicativo para consultas entre aplicativos. |
|
timespan |
string |
Opcional. O intervalo de tempo sobre o qual consultar dados. Esse é um valor ISO8601 período de tempo. Esse período de tempo é aplicado além de qualquer que seja especificado na expressão de consulta. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
Resposta bem-sucedida |
|
Other Status Codes |
Um objeto de resposta de erro. |
Segurança
oauth2
Conectar-se à API do Aplicativo Azure Insights
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io
Escopos
Nome | Description |
---|---|
user_impersonation | representar sua conta de usuário |
Exemplos
queryPost
Solicitação de exemplo
POST https://api.applicationinsights.io/v1/apps/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/query
{
"timespan": "PT12H",
"query": "requests | summarize count() by bin(timestamp, 1h)"
}
Resposta de exemplo
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
Nome | 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 do Analytics. 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.
Nome | Tipo | Description |
---|---|---|
name |
string |
O nome dessa coluna. |
type |
string |
O tipo de dados dessa coluna. |
errorDetail
Detalhes do erro.
Nome | 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 que foram responsáveis pelo erro. |
target |
string |
Indica qual propriedade na solicitação é responsável pelo erro. |
value |
string |
Indica qual valor em 'target' é responsável pelo erro. |
errorInfo
O código e a mensagem de um erro.
Nome | Tipo | Description |
---|---|---|
additionalProperties |
object |
|
code |
string |
Um código de erro legível do 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.
Nome | Tipo | Description |
---|---|---|
error |
O código e a mensagem de um erro. |
queryBody
A consulta do Analytics. Saiba mais sobre a sintaxe de consulta do Analytics
Nome | Tipo | Description |
---|---|---|
applications |
string[] |
Uma lista de IDs de aplicativo para consultas entre aplicativos. |
query |
string |
A consulta a ser executada. |
timespan |
string |
Opcional. O intervalo de tempo sobre o qual consultar dados. Esse é um valor ISO8601 período de tempo. Esse período de tempo é aplicado além de qualquer que seja especificado na expressão de consulta. |
queryResults
Uma resposta de consulta.
Nome | Tipo | Description |
---|---|---|
tables |
table[] |
A lista de tabelas, colunas e linhas. |
table
Uma tabela de resposta de consulta.
Nome | Tipo | Description |
---|---|---|
columns |
column[] |
A lista de colunas nesta tabela. |
name |
string |
O nome da tabela. |
rows |
string[] |
As linhas resultantes dessa consulta. |