Información sobre la observabilidad de Apigee

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

La Supervisión de la API de Apigee, las Estadísticas de la API de Apigee y los registros de acceso de Apigee son tres herramientas potentes que puedes usar para recopilar, observar y comprender los datos de uso de tu API. Cada una de estas herramientas proporciona estadísticas diferentes y se recomienda para distintos casos de uso. En este documento, se proporciona una breve descripción general del propósito de cada herramienta y su uso recomendado, como se describe en las siguientes secciones:

Supervisión de API

El objetivo de la Supervisión de API es proporcionar estadísticas en tiempo real sobre el rendimiento de la API para que puedas diagnosticar y solucionar problemas rápidamente y mantener tus APIs funcionando según lo previsto.

La Supervisión de APIs te proporciona datos agregados de tus proxies de API cada minuto, lo que te permite supervisar de cerca el estado y el rendimiento de tus APIs. Puedes usar API Monitoring para configurar alertas casi en tiempo real sobre parámetros especificados y aprovechar los datos agregados cuando realices la solución de problemas.

La supervisión de la API te permite hacer lo siguiente:

  • Mantener la disponibilidad de tus APIs.
  • Tomar medidas en función de las alertas antes de que los consumidores se vean afectados
  • Aprovechar los códigos de falla de Apigee para acelerar el diagnóstico de los problemas.
  • Aísla rápidamente las áreas con problemas para diagnosticar la fuente de los problemas de rendimiento y latencia.

Los clientes de Apigee también pueden usar las herramientas de Cloud Monitoring para admitir la Supervisión de API. Si deseas integrar otros sistemas de supervisión, te recomendamos que uses la API de Monitoring para extraer métricas.

Datos de latencia cuando se usa la supervisión de API

Dado que la supervisión de la API está diseñada intencionalmente para escalar, no registra cada medición de latencia individual en cada transacción. En su lugar, se usan buckets para medir las latencias. Buckets de latencia usan rangos predefinidos para agrupar los valores de latencia observados.

Para obtener más información sobre el uso de API Monitoring en tus APIs, consulta la Descripción general de API Monitoring.

Para obtener más información sobre cómo usar Monitoring junto con Apigee para configurar alertas, consulta Configura alertas y notificaciones.

Estadísticas de la API de Apigee

Las estadísticas de la API de Apigee proporcionan análisis de tendencias históricos y generación de informes detallados para los metadatos de las llamadas a la API. El objetivo de Apigee Analytics es ayudarte a comprender las tendencias a largo plazo del tráfico de tus APIs para que puedas asegurarte de que sean compatibles con los requisitos de tu empresa o realizar cambios si es necesario.

Con las Estadísticas de la API de Apigee, puedes elegir entre aproximadamente 50 dimensiones disponibles que especifican los datos que deseas capturar para cada llamada a la API que controla un proxy. Luego, puedes crear informes personalizados para determinar cómo cambian las métricas de las APIs específicas con el tiempo.

Los datos de estadísticas capturados se almacenan en BigQuery. Puedes usar Apigee API Analytics para crear informes personalizados en Looker Studio, configurar trabajos de informes personalizados asíncronos o exportar datos de estadísticas a tu propio Google Cloud repositorio de almacenamiento, como BigQuery.Si comienzas con los precios de pago por uso, API Analytics es un complemento opcional.

Estas son algunas de las tendencias que puedes identificar con Apigee Analytics:

  • En el tiempo, ¿cuáles son sus tendencias de tráfico de API?
  • ¿Cuáles son tus apps principales?
  • ¿Quiénes son sus principales desarrolladores?
  • ¿Cuándo es más rápido o más lento el tiempo de respuesta de la API?
  • ¿Qué regiones geográficas tienen la mayor cantidad de tráfico de APIs?

Datos de latencia cuando se usan las estadísticas de la API de Apigee

La latencia observada en Apigee API Analytics usa una función de agregación de cuantil aproximado en los registros individuales almacenados en BigQuery. Esto hace que los datos resultantes sobre la latencia sean más precisos en comparación con la lógica de discretización que se usa en API Monitoring. La latencia tanto en API Monitoring como en Apigee API Analytics se mide desde el entorno de ejecución de Apigee y no incluye los cálculos de latencia de los saltos de red anteriores, incluido Istio.

Para obtener más información sobre las estadísticas de la API de Apigee, consulta Descripción general de las estadísticas de la API de Apigee.

Registros de acceso de Apigee

Los registros de acceso de Apigee se pueden usar para solucionar problemas relacionados con las llamadas a la API de Apigee y para identificar qué APIs devuelven códigos de respuesta HTTP particulares.

Los registros de acceso de Apigee capturan registros por transacción en la puerta de enlace de entrada a Apigee. Esto te permite filtrar los registros según códigos HTTP específicos y solucionar fácilmente casos extremos, como un código de estado de respuesta de 0 en Istio.

Para obtener más información sobre cómo usar los registros de acceso de Apigee para solucionar problemas relacionados con tus APIs, consulta Registros de acceso de Apigee.

Diferencias entre los datos que muestran los datos de Supervisión de API y Analytics

La Supervisión de API y las estadísticas de la API de Apigee usan diferentes canalizaciones para acceder a los datos de las APIs. Como resultado, es posible que veas algunas discrepancias entre los datos que se muestran en los paneles de Apigee API Analytics y los datos disponibles en Supervisión de API.

Oportunidad y precisión

En general, los datos que muestran las estadísticas de la API de Apigee son más precisos, pero pueden tener un pequeño retraso (de menos de una hora) en comparación con los datos que muestra la Supervisión de API.

Retención de datos

Las estadísticas de la API de Apigee conservan los datos durante un período más largo que la supervisión de API, lo que las hace más adecuadas para el análisis de las tendencias a largo plazo.

Los períodos de retención de datos de Analytics y Supervisión de API son los siguientes:

  • Analytics

    • Estándar: 60 días
    • Empresa: 90 días
    • Enterprise +: 14 meses
  • Supervisión de API: 1 mes