Compartir a través de


Query - Execute

Ejecución de una consulta de Analytics
Ejecuta una consulta de Analytics para los datos. Este es un ejemplo de uso de POST con una consulta de Analytics.

POST https://api.applicationinsights.io/v1/apps/{appId}/query

Parámetros de identificador URI

Nombre En Requerido Tipo Description
appId
path True

string

Identificador de la aplicación. Este es el identificador de aplicación de la hoja Configuración de acceso de API en el Azure Portal.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
query True

string

Consulta que se va a ejecutar.

applications

string[]

Lista de identificadores de aplicación para consultas entre aplicaciones.

timespan

string

Opcional. Intervalo de tiempo en el que se van a consultar los datos. Se trata de un valor de período de tiempo ISO8601. Este intervalo de tiempo se aplica además de los especificados en la expresión de consulta.

Respuestas

Nombre Tipo Description
200 OK

queryResults

Respuesta correcta

Other Status Codes

errorResponse

Objeto de respuesta de error.

Seguridad

oauth2

Conexión a Aplicación de Azure Insights API

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io

Ámbitos

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

queryPost

Solicitud de ejemplo

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

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

Respuesta de muestra

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"
        ]
      ]
    }
  ]
}

Definiciones

Nombre Description
column

Una columna de tabla.

errorDetail

Detalles del error.

errorInfo

El código y el mensaje de un error.

errorResponse

Detalles del error.

queryBody

Consulta de Analytics. Más información sobre la sintaxis de consulta de Analytics

queryResults

Una respuesta de consulta.

table

Una tabla de respuesta de consulta.

column

Una columna de tabla.

Nombre Tipo Description
name

string

Nombre de esta columna.

type

string

Tipo de datos de esta columna.

errorDetail

Detalles del error.

Nombre Tipo Description
additionalProperties

object

code

string

Código del error.

message

string

Mensaje de error legible.

resources

string[]

Indica los recursos responsables del error.

target

string

Indica qué propiedad de la solicitud es responsable del error.

value

string

Indica qué valor de "destino" es responsable del error.

errorInfo

El código y el mensaje de un error.

Nombre Tipo Description
additionalProperties

object

code

string

Código de error legible de la máquina.

details

errorDetail[]

detalles del error.

innererror

errorInfo

El código y el mensaje de un error.
Detalles del error interno si existen.

message

string

Mensaje de error legible.

errorResponse

Detalles del error.

Nombre Tipo Description
error

errorInfo

El código y el mensaje de un error.
Los detalles del error.

queryBody

Consulta de Analytics. Más información sobre la sintaxis de consulta de Analytics

Nombre Tipo Description
applications

string[]

Lista de identificadores de aplicación para consultas entre aplicaciones.

query

string

Consulta que se va a ejecutar.

timespan

string

Opcional. Intervalo de tiempo en el que se van a consultar los datos. Se trata de un valor de período de tiempo ISO8601. Este intervalo de tiempo se aplica además de los especificados en la expresión de consulta.

queryResults

Una respuesta de consulta.

Nombre Tipo Description
tables

table[]

Lista de tablas, columnas y filas.

table

Una tabla de respuesta de consulta.

Nombre Tipo Description
columns

column[]

Lista de columnas de esta tabla.

name

string

Nombre de la tabla.

rows

string[]

Filas resultantes de esta consulta.