Supervisa el tráfico reciente de la API

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

El panel Recientes te permite supervisar el tráfico reciente de la API para todos los proxies de API y los servicios segmentados 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

En la vista de lista, se muestra información resumida de los proxies de API y los servicios de destino de tu organización que tuvieron tráfico recientemente.

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. Puedes volver a la vista de lista en cualquier momento haciendo clic en en el panel Recientes.

Página Recientes

Como se muestra en la figura, la vista de lista te permite hacer lo siguiente:

  • Consulta la información resumida de todos los proxies de API y 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 tendencias en tus datos de supervisión de APIs).
  • 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 de un 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 (como https://acme.com/api). Ingresa toda o 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 (Alerts only) para ver únicamente los proxies de API o los destinos de servicio 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 los datos detallados de un proxy de API o un servicio de destino, haz clic en su nombre en la vista de lista. Los datos detallados se muestran en el panel de la derecha.

Vista detallada

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

Además, si usas 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 del cronograma especificado (que se muestra en la imagen anterior), que incluye lo siguiente:

Detalles Descripción
Tráfico total Cantidad total de transacciones
Errores totales Cantidad total de errores.
Tasa de error total 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, se muestran indicadores de alerta en la IU.

Promedio de VPS Promedio de transacciones 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 objetivo (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.
Origen del error Desglose y porcentaje total de errores del paquete de proxy de la 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 objetivos

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 colores que te permite identificar los entornos que tienen alertas.

  • Verde indica que no se excedieron los umbrales de las condiciones de alerta.
  • El color rojo indica que se excedieron los umbrales de las condiciones 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, tal como se ve en la siguiente imagen.

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).
  • Filtra la pantalla seleccionando componentes de las listas desplegables o haciendo doble clic en un cuadro para desglosar aún más. En las listas desplegables de 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, define el valor de escalado en en logarítmico o lineal. La opción Lineal ajusta el tamaño de los cuadros según las proporciones de tráfico generales. Por ejemplo, un proxy con 200 llamadas tiene el doble de tamaño que un proxy con 100 llamadas.

    Ajustar mapa de calor

  • Busca en el mapa de calor ingresando toda o parte de una cadena relevante en el cuadro de búsqueda. Puedes buscar contenido en la región, el entorno, el proxy o los mapas de destino, según lo que se muestre en ese momento.

    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 red 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:

  • test se muestra red porque sus porcentajes de errores de tráfico superaron el umbral de 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 los componentes de las listas desplegables. También puedes hacer doble clic en un cuadro para desglosar desde el mapa de entorno hasta un mapa de proxy de API y desde un mapa de proxy de API hasta el mapa de objetivos de servicio para ese proxy de API a fin de 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 más alto, 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 los 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 de la derecha.

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:

Cuando haces clic en un cuadro en el mapa, también se muestra a simple vista la cantidad de llamadas y el porcentaje de errores de la última hora.

Información sobre el mapa 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 de desarrollador 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 los menús desplegables del filtro List View o Heat Map para ver más detalles. Nota: Los informes personalizados no están disponibles si los filtros Proxies y Targets se configuran 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 de la lista y ejecuta el informe personalizado.