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 |
---|---|---|---|---|
app
|
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 |
Respuesta correcta |
|
Other Status Codes |
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. |
error |
Detalles del error. |
error |
El código y el mensaje de un error. |
error |
Detalles del error. |
query |
Consulta de Analytics. Más información sobre la sintaxis de consulta de Analytics |
query |
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 |
detalles del error. |
|
innererror |
El código y el mensaje de un error. |
|
message |
string |
Mensaje de error legible. |
errorResponse
Detalles del error.
Nombre | Tipo | Description |
---|---|---|
error |
El código y el mensaje de un 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. |