Share via


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

queryResults

Resposta bem-sucedida

Other Status Codes

errorResponse

Um objeto de resposta de erro.

Segurança

oauth2

Conectar-se à API do Aplicativo Azure Insights

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

Scopes

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

queryPost

Sample Request

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

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

Sample Response

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.

errorDetail

Detalhes do erro.

errorInfo

O código e a mensagem de um erro.

errorResponse

Detalhes do erro.

queryBody

A consulta do Analytics. 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.

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

errorDetail[]

detalhes do erro.

innererror

errorInfo

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

message

string

Uma mensagem de erro legível por humanos.

errorResponse

Detalhes do erro.

Nome Tipo Description
error

errorInfo

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