Estás consultando la documentación de Apigee Edge.
Consulta la
documentación de Apigee X. Información
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 los datos de la API, tienen diferentes objetivos:
- El objetivo de la supervisión de API es asegurarse de que las API funcionen según lo previsto. Para ello, quieres ver los datos más recientes disponibles. La supervisión de API proporciona datos que son muy cercanos en tiempo real y te permite crear alertas que te notifican si surge un problema.
- El objetivo de Edge Analytics es comprender el comportamiento a largo plazo de tus APIs para que puedas asegurarte de que cumplen con los requisitos de tu empresa o realizar cambios si es necesario. Para estos propósitos, es menos importante ver los datos en tiempo real. Por lo tanto, los datos de Analytics se retrasan un poco, aunque, por lo general, de 10 minutos como máximo.
Ten en cuenta que los datos de supervisión de API, que en su mayoría están relacionados con los códigos de error y la latencia, son un pequeño subconjunto de datos de Analytics.
Diferencias entre los datos de supervisión de la API y los datos de Analytics
En esta sección, se describen algunas diferencias menores entre los datos que recopila Edge Analytics y la supervisión de API. Dado que Monitoring y Analytics de API usan canalizaciones de datos diferentes, es posible que veas pequeñas diferencias entre los informes personalizados que genera Monitoring y los que genera Analytics. Por ejemplo, es posible que veas discrepancias en los resultados informados para los errores de tiempo de espera, tanto los tiempos de espera del backend (código de estado HTTP 504 en la solicitud) como los tiempos de espera del cliente (código de estado HTTP 499). Estas pueden aparecer con el código de estado 200 en los informes personalizados de Analytics, pero con el código de estado 504 o 499 en los informes personalizados de Monitoring.Supervisión de API
La supervisión de APIs proporciona estadísticas en tiempo real sobre el rendimiento de las APIs y te ayuda a diagnosticar y solucionar rápidamente los problemas para que tus APIs sigan funcionando 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 de diagnóstico (MTTD)
- Toma las medidas adecuadas en función de las alertas contextuales antes de que los consumidores se vean afectados.
- Aprovecha los códigos de fallas de Apigee para acelerar los diagnósticos.
- Aísla las áreas problemáticas rápidamente para diagnosticar errores, rendimiento y latencia, así como su origen.
Estadísticas de la API de Edge
Edge API Analytics recopila y analiza la información que fluye a través de las APIs. Las estadísticas de API capturan información como la siguiente:
- Tendencias de tu tráfico de API a lo largo del tiempo
- ¿Cuáles son tus apps principales?
- ¿Quiénes son tus desarrolladores principales?
- Qué métodos de API son los más populares
- Cuándo el tiempo de respuesta de la API es más rápido o más lento
- La ubicación geográfica donde se observa la mayor cantidad de tráfico de API
Datos recopilados por las estadísticas de API
Estadísticas de API recopila y analiza una amplia variedad de datos que fluyen a través de las APIs. Por ejemplo, mientras se implementa tu API, Analytics registra de forma constante 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 usarlas, consulta Cómo usar las APIs de métricas para medir el rendimiento del programa de APIs. Para obtener una lista completa de las métricas, consulta la referencia de métricas, dimensiones y filtros de Analytics.
Recopila métricas personalizadas
También puedes recopilar métricas personalizadas mediante la política StatisticsCollector. La política StatisticsCollectionor puede escribir información de encabezados de solicitudes, cargas útiles XML/JSON, parámetros de consulta, URIs y otras ubicaciones en el servidor de Analytics para su análisis y generación de informes.
Accede a los datos de Analytics
Una vez que se generan, puedes acceder a métricas predefinidas y personalizadas con las herramientas de visualización de Analytics de la API, incluidos el Panel, los informes personalizados y el GeoMap. Para obtener más información sobre las herramientas de visualización proporcionadas por API de Analytics, consulta los paneles de Analytics. Para obtener más información sobre los informes personalizados, consulta Cómo crear informes personalizados.
Comparación de la supervisión de la API y el análisis de las API
Los desarrolladores de APIs usan tanto la supervisión de APIs como su análisis. Una de las principales diferencias entre ambos es el mecanismo de alerta integrado en API Monitoring. Las alertas permiten que tu equipo de operaciones responda a los problemas con tus APIs en tiempo real para garantizar que tus APIs estén disponibles y funcionen como se espera.
Las condiciones de alerta definen el código de estado específico (2xx/4xx/5xx), la latencia y los umbrales de código de fallas que, cuando se superan, activan 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 supervisión de API para investigar el problema y desglosar 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
- Solicitar UUID
- Y mucho más
Las estadísticas de API están diseñadas para capturar una amplia variedad de datos a fin de que los utilicen 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 puedan aumentar o reducir la escala verticalmente de tus servicios para satisfacer las cambiantes demandas.
- El equipo de marketing puede usar los datos de Analytics para determinar los patrones de uso que identifican las APIs, las apps, los clientes y otros datos individuales.
- 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 cargas útiles de solicitudes.