Uso de la interfaz de consulta de Internet Monitor

Una opción para obtener más información sobre el tráfico de Internet de su aplicación de AWS es usar la interfaz de consulta de Internet Monitor. Para utilizar la interfaz de consulta, debe crear una consulta con los filtros de datos que elija y, a continuación, ejecutar la consulta para obtener un subconjunto de los datos de Internet Monitor. Explorar los datos que devuelve la consulta puede proporcionar información sobre el rendimiento de su aplicación en Internet.

Puede consultar y explorar todas las métricas que Internet Monitor captura mediante el monitor, incluidas las puntuaciones de disponibilidad y rendimiento, los bytes transferidos, los tiempos de ida y vuelta y el tiempo hasta el primer byte (TTFB).

Internet Monitor utiliza la interfaz de consulta para proporcionar los datos que puede explorar en el panel de la consola de Internet Monitor. Puede consultar y filtrar los datos de Internet de la aplicación con las opciones de búsqueda del panel, en la página Analizar o en la página Optimizar.

Si desea tener una flexibilidad para explorar y filtrar sus datos mayor que la que ofrece el panel, puede usar la interfaz de consulta mediante las operaciones de la API de Internet Monitor mediante la AWS Command Line Interface o un AWS SDK. En esta sección, se presentan los tipos de consultas que puede usar con la interfaz de consultas y los filtros que puede especificar para crear un subconjunto de datos, a fin de obtener información sobre el tráfico de Internet de su aplicación.

Cómo utilizar la interfaz de consulta

Para crear una consulta con la interfaz de consulta, se elige un tipo de consulta y, a continuación, se especifican los valores de filtro para devolver el subconjunto específico deseado de los datos del archivo de registro. A continuación, puede trabajar con el subconjunto de datos para filtrar más detalladamente, ordenar y crear informes, etc.

El proceso de consulta funciona de la siguiente manera:

La interfaz de consultas proporciona los tres tipos de consultas que se presentan a continuación. Cada tipo de consulta devuelve un conjunto diferente de información sobre el tráfico de los archivos de registro, tal y como se muestra.

Es posible filtrar los datos más con criterios específicos. En la mayoría de los tipos de consultas, a excepción de las sugerencias de enrutamiento, se pueden aplicar filtros especificando uno o más de los siguientes criterios:

En el caso de este tipo de consultas se pueden filtrar aún más los datos especificando uno o más de los siguientes criterios:

Los operadores que puede utilizar para filtrar los datos son EQUALS y NOT_EQUALS. Para obtener más información sobre los parámetros de filtrado, consulte la operación de la API FilterParameter.

Para obtener más información sobre las operaciones de la interfaz de consulta, consulte las siguientes operaciones de la API en la Guía de referencia de la API de Internet Monitor:

Consultas de ejemplo

Para crear una consulta que pueda utilizar para recuperar un conjunto de datos filtrados del archivo de registro del monitor, utilice la operación de la API StartQuery. Debe especificar un tipo de consulta y filtrar los parámetros para esta. Cuando utilice la operación de la API de la interfaz de consultas de Internet Monitor para obtener los resultados de la consulta mediante el uso de la consulta, recuperará el subconjunto de datos con el que desee trabajar.

Veamos algunos ejemplos para ilustrar cómo funcionan los tipos de consulta y los parámetros de filtro.

Ejemplo 1

Supongamos que desea recuperar todos los datos del archivo de registro del monitor de un país específico, a excepción de una ciudad. El siguiente ejemplo muestra los parámetros de filtro de una consulta que podría crear mediante la operación StartQuery para este escenario.

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "MEASUREMENTS"
   FilterParameters: [
      {
       Field: "country",
       Operator: "EQUALS",
       Values: ["Germany"]
      },
      {
       Field: "city",
       Operator: "NOT_EQUALS",
       Values: ["Berlin"]
      },
    ]
}

Ejemplo 2

Como otro ejemplo, supongamos que desea ver las ubicaciones principales por área metropolitana. Puede usar la siguiente consulta de ejemplo para este escenario.

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "TOP_LOCATIONS"
   FilterParameters: [
      {
       Field: "geo",
       Operator: "EQUALS",
       Values: ["metro"]
      },
    ]
}

Ejemplo 3

Supongamos que quiere ver las principales combinaciones de redes urbanas en el área metropolitana de Los Ángeles. Para ello, especifique geo=city y, a continuación, establezca metro en Los Ángeles. Ahora, la consulta devuelve las principales redes urbanas del área metropolitana de Los Ángeles en lugar de las principales áreas metropolitanas + redes en general.

Este es el ejemplo de consulta que puede usar:

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "TOP_LOCATIONS"
   FilterParameters: [
      {
       Field: "geo",
       Operator: "EQUALS",
       Values: ["city"]
      },
      {
       Field: "metro",
       Operator: "EQUALS",
       Values: ["Los Angeles"]
      }
    ]
}

Ejemplo 4

Ahora supongamos que desea recuperar los datos de TTFB de una subdivisión específica (por ejemplo, un estado de EE. UU.).

El siguiente es un ejemplo de consulta para este escenario:

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "TOP_LOCATION_DETAILS"
   FilterParameters: [
      {
       Field: "subdivision",
       Operator: "EQUALS",
       Values: ["California"]
      },
    ]
}

Ejemplo 5

Y ahora, supongamos que desea recuperar los datos de TTFB de cada ubicación en la que haya tráfico de clientes en la aplicación.

El siguiente es un ejemplo de consulta para este escenario:

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "OVERALL_TRAFFIC_SUGGESTIONS"
   FilterParameters: []
}

Results:
[us-east-1, 40, us-west-2, 30],
[us-east-1, 40, us-west-1, 35],
[us-east-1, 40, us-east-1, 44],
[us-east-1, 40, CloudFront, 22],
...
[us-east-2, 44, us-west-2, 30],
[us-east-2, 44, us-west-1, 35],
...

Ejemplo 6

Digamos que desea recuperar datos de TTFB de una nueva Región de AWS específica.

El siguiente es un ejemplo de consulta para este escenario:

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "OVERALL_TRAFFIC_SUGGESTIONS_DETAILS"
   FilterParameters: [
      {
       Field: "proposed_aws_location",
       Operator: "EQUALS",
       Values: ["us-west-2"]
      },
   ]
}

Results:
[San Jose, San Jose-Santa Clara, California, United States, 7922, us-east-1, 40, 350, 350, us-west-2, 45]
[San Jose, San Jose-Santa Clara, California, United States, 7922, us-west-1, 35, 450, 450, us-west-2, 45]

Ejemplo 7

Un último ejemplo consiste en recuperar datos para solucionadores de DNS específicos.

El siguiente es un ejemplo de consulta para este escenario:

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "ROUTING_SUGGESTIONS"
   FilterParameters: [
      {
       Field: "proposed_aws_location",
       Operator: "EQUALS",
       Values: ["us-east-1"]
      },
   ]
}

Results:
[162.158.180.245, 13335, Cloudflare, [5.4.0.0/14], us-east-2, 200.0, us-east-1, 160.0]
[162.158.180.243, 13313, Cloudflare, [5.4.0.0/10], us-east-2, 150.0, us-east-1, 125.0]

Obtención de los resultados de la consulta

Tras definir una consulta, puede devolver un conjunto de resultados mediante la consulta, ejecutando otra operación de la API de Internet Monitor, GetQueryResults. Cuando ejecuta GetQueryResults, especifica el ID de consulta de la consulta que definió, junto con el nombre del monitor. GetQueryResults recupera los datos de la consulta especificada en un conjunto de resultados.

Cuando ejecute una consulta, asegúrese de que esta haya terminado de ejecutarse antes de usar GetQueryResults para ver los resultados. Puede determinar si la consulta se completó mediante la operación de la API GetQueryStatus. Cuando el Status de la consulta sea SUCCEEDED, puede continuar con la revisión de los resultados.

Cuando finalice la consulta, puede usar la siguiente información como ayuda para la revisión de los resultados. Cada tipo de consulta que utilice para crear una consulta incluye un conjunto único de campos de datos de los archivos de registro, tal y como se describe en la siguiente lista:

Cuando ejecuta la operación de la API GetQueryResults, Internet Monitor devuelve lo siguiente en la respuesta:

Solución de problemas

Si se devuelven errores cuando usa las operaciones de la API de la interfaz de consulta, compruebe que dispone de los permisos necesarios para usar Internet Monitor. Asegúrese específicamente de que tiene habilitados los siguientes permisos:

internetmonitor:StartQuery
internetmonitor:GetQueryStatus
internetmonitor:GetQueryResults
internetmonitor:StopQuery

Estos permisos se incluyen en la política de AWS Identity and Access Management recomendada para usar el panel de control de Internet Monitor de la consola. Para obtener más información, consulte Políticas administradas de AWS para Internet Monitor.