Supervisa el tráfico reciente de la API

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X.
info

El panel Recientes te permite supervisar el tráfico reciente de la API para todos los proxies de API y los servicios de destino de tu organización durante la última hora. Los datos de supervisión de la API se pueden mostrar como una lista detallada o un mapa de calor. Explora cada vista en las siguientes secciones:

Usa la vista de lista

La vista de lista muestra información resumida de los proxies de API y los servicios de destino de tu organización que tuvieron tráfico en el pasado reciente.

Explorar la vista de lista

Para mostrar la vista de lista, seleccione Analizar > API Monitoring > Recientes en la IU de Edge.

La vista de lista se muestra de forma predeterminada. Para volver a la vista de lista en cualquier momento, haz clic en en el panel Recientes.

Página Recientes

Tal como se destaca en la figura anterior, la vista de lista te permite hacer lo siguiente:

  • Visualiza información resumida de todos los proxies de API y los servicios de destino de tu organización que tuvieron transacciones en la última hora. Los proxies de API y los servicios de destino se enumeran por región y entorno. (Para obtener una vista histórica más amplia, consulta Identifica las tendencias en los datos de supervisión de la API).
  • Identifica los proxies de API y los servicios de destino que tienen alertas con rapidez. (Consulta Cómo configurar alertas y notificaciones para obtener información sobre la configuración de alertas.)
  • Haz clic en el nombre de un proxy de API o servicio de destino en la lista para ver datos detallados en el panel derecho.
  • Con el contexto actual, realiza rápidamente las siguientes tareas (las opciones están inhabilitadas si no son aplicables al contexto actual seleccionado):

    • Crea un informe personalizado y agrega dimensiones adicionales. Haz clic en .
    • Crea una alerta y agrega condiciones adicionales de alerta, configura notificaciones y genera un informe personalizado basado en la alerta.
    • Visualiza el contexto actual en el panel Cronograma o Investigar. Haz clic en Menú Más > View in Timeline o View in Investigate, respectivamente.
  • Busca en la vista de lista por nombre o URL (por ejemplo, https://acme.com/api). Ingresa la totalidad o una parte de una cadena relevante en el cuadro de búsqueda. Puedes buscar contenido en los campos Proxy, Destinos o Región.

    Nota: Si se selecciona el filtro Solo alertas, solo se mostrarán los proxies de API o los servicios de destino que tengan alertas en los resultados de la búsqueda.

  • Habilita o inhabilita la actualización automática de la página, según sea necesario.

  • Muestra y oculta los detalles del servicio de destino en la lista.

Identifica los proxies de API y los servicios de destino que tienen alertas

Cuando veas la vista de lista, un ícono de advertencia de color rojo y la línea de borde roja indican que los proxies de API y los servicios de destino tienen alertas.

Haz clic en Solo alertas para mostrar solo los proxies de API o los destinos de servicios que tienen alertas.

Solo alertas

Para ver rápidamente un resumen de la cantidad de errores 4xx y 5xx y la tasa de error general, coloca el puntero del mouse sobre cualquiera de los valores numéricos de la tabla.

Visualiza datos detallados de un proxy de API o servicio de destino

Para ver datos detallados de un proxy de API o servicio de destino, haz clic en su nombre en la vista de lista. Los datos detallados se muestran en el panel derecho.

Vista detallada

Haz clic en las siguientes pestañas para ver más información:

Además, con el contexto actual, puedes realizar rápidamente las siguientes tareas:

Nota: Las opciones aparecen inhabilitadas si no se aplican al contexto actual seleccionado.

  • Crea un informe personalizado y agrega dimensiones adicionales. Haz clic en .
  • Crea una alerta y agrega condiciones adicionales de alerta, configura notificaciones y genera un informe personalizado basado en la alerta. Haz clic en Menú Más > Create Alert.
  • Visualiza el contexto actual en el panel Cronograma o Investigar. Haz clic en Menú Más > View in Timeline o View in Investigate, respectivamente.

Detalles

La pestaña Detalles proporciona una vista rápida de los datos de tráfico para el cronograma especificado (que se muestra en la figura anterior), incluidos los siguientes:

Detalles Descripción
Tráfico total Cantidad total de transacciones.
Total de errores Cantidad total de errores
Tasa de error total El porcentaje de tráfico que generó errores (errores totales/tráfico total).

Nota: API Monitoring compara este porcentaje con las condiciones de alerta que estableces. Si la tasa de error total supera los umbrales, los indicadores de alerta se muestran en la IU.

TPS promedio Transacciones promedio por segundo
Latencia total (P99) Valor de latencia de respuesta total en el percentil 99 calculado en una ventana progresiva de5 minutos.
Nota: Solo se muestra para proxies de API.
Latencia de destino (P99) Valor de latencia de respuesta de destino en el percentil 99 calculado en una ventana progresiva de 5 minutos.
Nota: Solo se muestra para proxies de API.
Fuente de error Desglose y porcentaje total de errores de los proxies de API (4xx y 5xx) que se produjeron.

La pestaña Trends muestra los siguientes gráficos para el componente seleccionado:

  • Tasa de errores 4xx y 5xx
  • Tráfico (TPS)
  • Latencia total (ms)
  • Latencia de todos los destinos

Coloca el cursor sobre diferentes puntos en el gráfico para mostrar rápidamente los porcentajes de errores resumidos, los recuentos totales de tráfico y las latencias, respectivamente, en cada punto.

Tendencias

Registros

En la pestaña Registros, filtre por 4xx, 5xx o Todos los errores, y restringe el origen de los errores según el proxy de API, el servicio de destino (su servicio) o Apigee (infraestructura de Apigee).

Registros

Haz clic en un error para abrir el diálogo de registros y expandir sus detalles en la lista.

Registros

Usa el Mapa de calor

El mapa de calor proporciona una vista de bloques de color que te permite identificar qué entornos tienen alertas.

  • El color verde indica que no se superaron los umbrales de la condición de alerta.
  • El color rojo indica que se superaron los umbrales de la condición de alerta y que se activaron las alertas.

Explora el mapa de calor

Haz clic en en la página Recientes para mostrar el mapa de calor, que se muestra en la siguiente figura.

Mapa de calor

Como se muestra en la figura anterior, el Mapa de calor te permite hacer lo siguiente:

  • Identifica los proxies de API y los servicios de destino que tienen alertas con rapidez. (Consulta Cómo configurar alertas y notificaciones para obtener información acerca de cómo configurar alertas).
  • Para filtrar la pantalla, selecciona componentes de las listas desplegables o haz doble clic en un cuadro para obtener más detalles. En las listas desplegables Proxies y Destinos, puedes filtrar con una colección. Por ejemplo:
  • Haz clic en un bloque del mapa de calor para ver datos detallados en el panel derecho.
  • Con el contexto actual, realiza rápidamente las siguientes tareas (las opciones están inhabilitadas si no son aplicables al contexto actual seleccionado):

    • Crea un informe personalizado y agrega dimensiones adicionales. Haz clic en .
    • Crea una alerta y agrega condiciones adicionales de alerta, configura notificaciones y genera un informe personalizado basado en la alerta. Haz clic en Menú Más > Create Alert.
    • Visualiza el contexto actual en el panel Cronograma o Investigar. Haz clic en Menú Más > View in Timeline o View in Investigate, respectivamente.
  • Para establecer la escala de visualización del mapa de calor, configura scaled by como logarítmico o lineal. El tamaño lineal de los cuadros se basa en las proporciones de tráfico total. Por ejemplo, un proxy con 200 llamadas es el doble del tamaño de un proxy con 100 llamadas.

    Ajustar el mapa de calor

  • Para buscar en el mapa de calor, ingresa la totalidad o una parte de una cadena relevante en el cuadro de búsqueda. Puedes buscar contenido en los mapas de región, entorno, proxy o destino, según lo que se muestre actualmente.

    Nota: Si se selecciona el filtro Solo alertas, solo se mostrarán los proxies de API o los servicios de destino que tengan alertas en los resultados de la búsqueda.

  • Habilita o inhabilita la actualización automática de la página, según sea necesario.

Identifica los proxies de API y los servicios de destino que tienen alertas

Cuando se ve el mapa de calor, el bloque rojo indica qué entornos, proxies de API y servicios de destino tienen alertas. Para obtener más información sobre la configuración de alertas, consulta Configura alertas y notificaciones.

Por ejemplo, en la siguiente figura, se muestran dos entornos:

  • El entorno test es rojo porque sus porcentajes de errores de tráfico superaron el límite de la condición de alerta que estableciste para el cronograma especificado.
  • El entorno prod es verde porque sus porcentajes de errores de tráfico no superaron el límite de la condición de alerta para el cronograma especificado.

Mapa de calor

Para filtrar la pantalla, selecciona componentes de las listas desplegables. O bien, haz doble clic en un cuadro para obtener más detalles desde el mapa del entorno hasta un mapa de proxy de API y, desde un mapa de proxy de API, hasta el mapa de destinos de servicios para ese proxy de API para identificar los proxies de API y los servicios de destino que tienen alertas.

Entorno >> Proxy >> Destino

Haz clic en Solo alertas para mostrar solo los entornos, proxies de API o destinos de servicios que tienen alertas, según lo que se muestra actualmente.

Para volver a un nivel superior, haz clic en Flecha del mapa de calor.

Visualiza los datos detallados de un entorno, un proxy de API o un servicio de destino

Para ver datos detallados de un entorno, un proxy de API o un servicio de destino, haz clic en el cuadro correspondiente en el mapa de calor. Los datos detallados se muestran en el panel derecho.

Mapa de calor

Las pestañas proporcionan la misma información que se proporciona en la vista de lista. Para obtener más información, consulta las secciones siguientes:

Si haces clic en un cuadro del mapa, también se muestra rápidamente la cantidad de llamadas y la tasa de error durante la última hora.

Información sobre herramientas de mapas de calor

Crea un informe personalizado en el panel Recientes

Crea un informe personalizado basado en el conjunto de condiciones seleccionado. Puedes editar el informe personalizado después de crearlo para agregar o borrar métricas y dimensiones, según sea necesario. Por ejemplo, es posible que desees limitar tu investigación a un token de acceso, una app para desarrolladores o un proxy de API en particular. Para obtener más información, consulta Referencia de métricas, dimensiones y filtros de Analytics.

Para obtener más información, consulta Crea informes personalizados.

Crea un informe personalizado en el panel Recientes:

  1. En la IU de Edge, haga clic en Analizar > API Monitoring > Recientes.
  2. Selecciona un proxy de API o un servicio de destino en las listas desplegables de filtros de la vista de lista o del mapa de calor para ver más detalles. Nota: Los informes personalizados no están disponibles si los filtros Proxies y Destinos se establecen en All.

  3. En la esquina derecha, haz clic en Crea informe personalizado.

    La página del informe personalizado se muestra en una pestaña nueva con campos relevantes antes propagados y dimensiones y métricas predeterminadas. De forma predeterminada, el informe personalizado se asigna de la siguiente manera: API Monitoring Recent Generated Nota: Si ya existe un informe personalizado para el contexto actual, se abre.

  4. Edita el informe personalizado como desees y haz clic en Guardar.

  5. Haz clic en el nombre del informe en la lista y ejecuta el informe personalizado.