Estás viendo la documentación de Apigee Edge.
Ir a la
documentación de Apigee X. info
En esta sección, se compara la supervisión de API con Edge Analytics. Si bien la supervisión de API y Edge Analytics te permiten recopilar y ver datos de API, tienen objetivos diferentes:
- El objetivo de la supervisión de API es garantizar que tus APIs estén en funcionamiento según lo previsto. Para ello, debes ver los datos más recientes disponibles. La supervisión de API proporciona datos muy cercanos al tiempo real y te permite crear alertas que te notifiquen en caso de que surja un problema.
- El objetivo de Edge Analytics es comprender el comportamiento a largo plazo de tus APIs para que puedas asegurarte de que sean compatibles con los requisitos de tu empresa o realizar cambios si es necesario. Para estos fines, es menos importante ver datos en tiempo real. En consecuencia, los datos de Analytics se retrasan un poco, aunque, por lo general, no más de 10 minutos.
Ten en cuenta que los datos de la supervisión de API, que se relacionan principalmente con los códigos de error y la latencia, son un pequeño subconjunto de los datos de Analytics.
Diferencias entre los datos de la supervisión de API y los datos de Analytics
En esta sección, se describen algunas diferencias menores entre los datos recopilados por Edge Analytics y la supervisión de API. Dado que la supervisión de API y Analytics usan diferentes canalizaciones de datos, es posible que veas pequeñas diferencias entre los informes personalizados generados por Monitoring y los informes generados por Analytics. Por ejemplo, es posible que veas discrepancias en los resultados informados para los errores de tiempo de espera: tiempos de espera del backend (código de estado HTTP 504 en la solicitud) y tiempos de espera del cliente (código de estado HTTP 499). Estos pueden aparecer con el código de estado 200 en los informes personalizados de Analytics, pero aparecerán con el código de estado 504 o 499 en los informes personalizados de Monitoring.Supervisión de API
La supervisión de API proporciona estadísticas en tiempo real sobre el rendimiento de la API y te ayuda a diagnosticar y solucionar problemas para que tus APIs funcionen según lo previsto.
La supervisión de la API te permite lo siguiente:
- Aumentar la disponibilidad de la API y reducir el tiempo promedio del diagnóstico (MTTD).
- Tomar las medidas adecuadas en función de las alertas contextuales antes de que los consumidores se vean afectados.
- Aprovechar los códigos de falla de Apigee para acelerar el diagnóstico.
- Aislar las áreas con problemas para diagnosticar errores, el rendimiento y los problemas de latencia y sus fuentes.
Edge API Analytics
Edge API Analytics recopila y analiza la información que fluye a través de las APIs. API Analytics captura información como la siguiente:
- Cómo evolucionan tus tendencias de tráfico de APIs en el tiempo
- Cuáles son tus apps principales
- Quiénes son tus principales desarrolladores
- Qué métodos de API son más populares
- Cuándo es más rápido o más lento el tiempo de respuesta de la API
- Geográficamente, dónde se concentra la mayor parte del tráfico de API
Datos recopilados por API Analytics
API Analytics recopila y analiza un amplio espectro de datos que fluyen a través de las APIs. Por ejemplo, mientras se implementa tu API, Analytics registra constantemente la cantidad de mensajes recibidos, la cantidad de desarrolladores, los tiempos de respuesta, los errores, la cantidad de apps en uso, el tamaño de la solicitud y muchos otros datos.
Para obtener una buena introducción a las métricas y cómo puedes usarlas, consulta Usa las APIs de métricas para medir el rendimiento del programa de API. Para obtener una lista completa de las métricas, consulta Referencia de métricas, dimensiones y filtros de Analytics.
Recopila métricas personalizadas
También puedes recopilar métricas personalizadas con la política StatisticsCollector. La política StatisticsCollector puede escribir información de los encabezados de solicitud, las cargas útiles de XML/JSON, los parámetros de consulta, los URIs y otras ubicaciones en el servidor de Analytics para el análisis y la generación de informes.
Accede a los datos de Analytics
Una vez generadas, puedes acceder a las métricas predefinidas y personalizadas con las herramientas de visualización de API Analytics, incluidos el panel, los informes personalizados y GeoMap. Para obtener más información sobre las herramientas de visualización que proporciona API Analytics, consulta Paneles de Analytics. Para obtener más información sobre los informes personalizados, consulta Crea informes personalizados.
Compara la supervisión de API y API Analytics
Los desarrolladores de API usan la supervisión de API y API Analytics. Una de las principales diferencias entre ambas es el mecanismo de alertas integrado en la supervisión de API. Las alertas permiten que tu equipo de operaciones responda a los problemas con tus APIs en tiempo real para garantizar que estén disponibles y funcionen como se espera.
Las condiciones de alerta definen un código de estado específico (2xx/4xx/5xx), latencia y límites de código de falla que indican cuando se excedieron las alertas visuales en la IU y envían notificaciones a través de una variedad de canales, como correo electrónico, Slack, PagerDuty o webhooks. Puedes configurar alertas en el entorno, el proxy de API o el servicio de destino, o en la región.
Después de que se activa una alerta, tu equipo de operaciones puede usar la IU de la supervisión de API para investigar el problema y obtener más detalles sobre su causa raíz. Luego, puedes generar un informe personalizado que incluya información predefinida sobre la alerta, como la siguiente:
- Tiempo total de respuesta
- Tiempo de respuesta del destino
- Errores del proxy
- Errores del destino
- UUID de la solicitud
- Y mucho más
API Analytics está diseñado para capturar una amplia variedad de datos para que los usen varios equipos. Por ejemplo:
- El equipo de operaciones puede usar los datos de Analytics para identificar períodos de tráfico alto o bajo, de modo que pueda escalar verticalmente o reducir la escala verticalmente los servicios para satisfacer las demandas cambiantes.
- El equipo de marketing puede usar los datos de Analytics para determinar los patrones de uso de los clientes identificados por APIs, apps, clientes o cualquier otro dato.
- Todos los equipos pueden acceder a los datos personalizados recopilados de una solicitud para hacer un seguimiento de información específica, como valores de encabezado, parámetros de consulta o carga útil de la solicitud.