Partilhar via


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
appId
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

queryResults

Resposta com êxito

Other Status Codes

errorResponse

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.

errorDetail

Detalhes do erro.

errorInfo

O código e a mensagem de um erro.

errorResponse

Detalhes do erro.

queryBody

A consulta Análise. Saiba mais sobre a sintaxe de consulta do Analytics

queryResults

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

errorDetail[]

detalhes do erro.

innererror

errorInfo

O código e a mensagem de um erro.
Detalhes do erro interno, se existirem.

message

string

Uma mensagem de erro legível por humanos.

errorResponse

Detalhes do erro.

Name Tipo Description
error

errorInfo

O código e a mensagem de um erro.
Os detalhes do 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.