Descripción general de la API de Analytics

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

En este tema, se presentan las estadísticas de la API de Edge.

Video: Mira un video breve para obtener una descripción general de los servicios de estadísticas de la API de Edge.

Mejora tu API a través de estadísticas

Edge API Analytics recopila y calcula una gran cantidad de información que fluye a través de proxies de API. Puedes visualizar estos datos con gráficos en la IU de Edge o puedes descargar los datos sin procesar para su análisis sin conexión mediante las APIs de administración de Edge.

Analytics te permite responder preguntas comunes, como las siguientes:

  • En el tiempo, ¿cuáles son mis tendencias de tráfico de API?
  • ¿Qué métodos de API son más populares?
  • ¿Quiénes son mis desarrolladores principales?
  • ¿Cuándo es más rápido el tiempo de respuesta de la API? ¿Y cuándo es más lento?
  • Geográficamente, ¿dónde veo la mayor parte del tráfico de API?

Las respuestas a preguntas como estas te ayudan a mejorar las API, solucionar problemas y tomar mejores decisiones empresariales relacionadas con tu programa de API.

Las estadísticas de la API ayuda a mejorar a todos

A través de un proceso continuo de recopilación, análisis y visualización de datos, las estadísticas de la API de Edge ayudan a tu equipo de APIs a mejorar sus APIs y a los desarrolladores de apps a mejorar sus apps:

alt_text
  • Equipo de API: El equipo de API aprovecha los sistemas internos para crear API interesantes. El equipo de API desea saber cómo funciona en general el programa de API, cuál es el rendimiento de las API individuales y cómo mejorar sus API.
  • Desarrolladores de apps: Compartir información de estadísticas con los desarrolladores de apps permite obtener mejores apps. Estos desarrolladores innovan con tu API y compilan apps creativas que te ayudan a aumentar los ingresos de tu empresa. Las estadísticas ayudan a los desarrolladores de aplicaciones a conocer el rendimiento de sus aplicaciones, lo que contribuye al resultado de empresa. Los desarrolladores de aplicaciones quieren saber cómo pueden mejorar sus apps.
  • Equipo de operaciones: El equipo de operaciones desea comprender los patrones de tráfico y prever cuándo agregar recursos de backend o realizar otros ajustes críticos.
  • Propietario de la empresa: El propietario de la empresa desea ver cómo se mejora su inversión en la API y dónde invertir en el futuro.

¿Qué tipo de datos se recopilan y analizan?

Analytics para la API de Edge recopila y analiza una amplia variedad de datos que fluyen a través de proxies de API, como los siguientes:

  • Tiempo de respuesta
  • Latencia de la solicitud
  • Tamaño de la solicitud
  • Errores del destino
  • Nombre del producto de la API
  • Dirección de correo electrónico del desarrollador
  • Nombre de la app
  • Muchas cosas más

Para obtener una lista completa de los datos que recopila API Analytics, consulta la referencia de métricas, dimensiones y filtros de Analytics.

¿Cómo puedo recopilar datos de estadísticas personalizados?

Edge recopila una enorme cantidad de datos de forma nativa. También puedes recopilar datos de estadísticas personalizados específicos de proxies de API, apps, productos o desarrolladores. Por ejemplo, es posible que desees recopilar datos de estadísticas de parámetros de búsqueda, encabezados de solicitud, cuerpos de solicitudes y respuestas, o variables que definas en tus API.

Recopilas datos de estadísticas personalizados mediante la política de Statistics Collector. Una vez que se extraen los datos personalizados, puedes usar la IU o la API de Analytics para examinarlos. Consulta Analiza el contenido de los mensajes de la API mediante estadísticas personalizadas para obtener un ejemplo completo que demuestra cómo recopilar datos de estadísticas personalizadas.

Diferencias entre los datos de Analytics y los de API Monitoring

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.

¿Cuándo están disponibles mis datos de estadísticas y durante cuánto tiempo?

Existen dos intervalos que controlan cuándo puede ver sus datos de estadísticas por cuánto tiempo puede hacerlo:

  • Intervalo de demora en los datos: Después de realizar una llamada a un proxy de API, los datos pueden tardar hasta 10 minutos en estar disponibles para su visualización o a través de llamadas a la API de administración.
  • Retención de datos: La cantidad de tiempo que el perímetro conserva los datos de estadísticas depende del plan. Según tu plan, es posible que los datos de Analytics estén disponibles para los últimos 30, 60, 90 o 365 días.

¿Cómo puedo acceder a mis datos de estadísticas?

Analytics de la API de Edge proporciona herramientas de visualización de datos integradas en la IU de Edge. Estas herramientas incluyen paneles de análisis predefinidos y, también, informes personalizados que muestran datos en grafos y gráficos, y te permiten desglosar los datos agrupados en dimensiones diferentes (por ejemplo, por proxy de API, dirección IP o código de estado HTTP).

Además, puedes descargar datos de estadísticas mediante la API de Edge Management. Una vez descargados, puedes importar esos datos a tus propias herramientas de visualización de datos o sistema de estadísticas.

Paneles de estadísticas

La IU de Edge proporciona un conjunto de paneles predefinidos que puedes usar para ver datos de estadísticas. Por ejemplo, en las siguientes imágenes, se muestra el panel Proxy Performance:

En este panel, se incluyen gráficos para los siguientes elementos:

  • Tráfico total: La cantidad total de solicitudes a la API que recibe Edge para un entorno de API de una organización.
  • Éxito del tráfico: La cantidad total de solicitudes que generaron una respuesta exitosa. Las respuestas de error no cuentan.
  • Errores de tráfico: La cantidad total de todas las solicitudes a la API que no se realizaron correctamente, es decir, la solicitud no entrega una respuesta. El recuento incluye errores de proxy (de Apigee) y errores de destino (los servicios de backend).
  • Promedio de TPS: Cantidad promedio de solicitudes a la API y respuestas resultantes por segundo.

Entre los paneles predefinidos adicionales, se incluyen los siguientes:

Para obtener más información sobre estos paneles predefinidos, consulta la sección sobre cómo usar los paneles de estadísticas.

Informes personalizados

Con los informes personalizados, puedes desglosar las métricas específicas de la API y ver los datos exactos que deseas visualizar. Puedes crear un informe personalizado con los datos de estadísticas integrados en Edge o con los datos de estadísticas personalizados que recopila la política Statistics Collector.

Cuando compilas un informe personalizado, selecciona los datos que deseas ver (métricas), agrupa los datos de manera significativa (dimensiones) y, de manera opcional, limita los datos que se muestran en función de características específicas de los datos (filtrado).

También puede establecer el tipo de gráfico que se muestra en el informe personalizado como una columna o un gráfico de líneas. En las siguientes imágenes, se muestran ejemplos de gráficos de transacciones por segundo agrupadas por el proxy de API:

  • Columna: Cada proxy de API está representado por una columna diferente:

    Gráfico de columnas personalizado

  • Línea: Cada proxy de API está representado por una línea diferente:

    Gráfico de líneas personalizado

Para obtener más información, consulte Crea y administra informes personalizados.

API de Analytics

Usa la API de Edge Management para descargar datos de estadísticas. Por ejemplo, puedes usar la API para crear tus propias herramientas de visualización, que puedes incorporar en portales o aplicaciones personalizadas.

Esta es un ejemplo de una llamada a la API a fin de recuperar datos de estadísticas para proxies de API:

curl  https://api.enterprise.apigee.com/v1/o/org_name/environments/test/stats/apiproxy?"select=sum(message_count)&timeRange=6/24/2018%2000:00~6/24/2018%2023:59&timeUnit=hour" \
-u email:password

Esta llamada mostrará lo siguiente:

  • La suma de solicitudes (recuento de mensajes) por proxy de API
  • Por un período de 24 horas
  • Agrupado por hora

El parámetro de consulta timeRange especifica el período en el siguiente formato:

?timeRange=MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM

Observa el %20 antes de HH:MM. El parámetro timeRange requiere un carácter de espacio con codificación URL antes de HH:MM o un carácter +, como en MM/DD/YYYY+HH:MM~MM/DD/YYYY+HH:MM.

Para obtener más información, consulta Cómo usar las APIs de métricas para medir el rendimiento del programa de APIs.

Exporta datos de estadísticas a Google Cloud

Puedes usar la API de Edge Management para exportar todos los datos de estadísticas de un día completo desde Edge a tu propio repositorio de datos, como Google Cloud Storage o BigQuery. Luego, puedes aprovechar las potentes capacidades de consulta y aprendizaje automático que ofrecen BigQuery y TensorFlow de Google Cloud para realizar tu propio análisis de datos.

Para obtener más información, consulta Exporta datos de Analytics.

¿Cómo comparto datos con los desarrolladores de apps?

Cuando pienses en los desarrolladores de apps como tus clientes, querrás asegurarte de que tengan las herramientas y la información disponibles para que aprovechen tu API al máximo.

alt_text

Los desarrolladores de apps no solo están interesados en la calidad de sus apps, sino que están muy interesados en tus API. Los portales para desarrolladores basados en Drupal incluyen una página opcional Rendimiento de la aplicación, diseñada para dar a los desarrolladores de apps acceso a métricas importantes de sus apps. En esta página, se ofrece a los desarrolladores información sobre lo siguiente:

  • Errores: ¿Qué errores de la API ve mi app?
  • Rendimiento: ¿La API resulta lenta en este momento? ¿Qué métodos de API suelen ser lentos o son lentos en este momento?
  • Disponibilidad: ¿La API está activa o no disponible en este momento?
  • Cuota: ¿tu API tiene una cuota? Como desarrollador de app, ¿cómo está mi cuota?

Para obtener más información, consulta lo siguiente:

Además, puedes compartir estadísticas con tus desarrolladores de las siguientes maneras:

¿Cómo genero datos de estadísticas completos?

¿Qué queremos decir con estadísticas completas? Por ejemplo, puedes crear un proxy de API y Edge recopilará datos de estadísticas sobre ese proxy. Sin embargo, ¿qué ocurre con las métricas para el desarrollador o la app que llamó al proxy de API? Si Edge no sabe quién realizó la llamada a la API, no podrá recopilar esos datos.

Debes seguir algunos pasos para permitir que Edge determine qué desarrolladores y qué apps para desarrolladores llaman a los proxies de API. A continuación, te mostramos una lista de los pasos con vínculos para obtener información más detallada:

  1. Crea uno o más productos de API, que es una agrupación de proxies de API junto con un plan de servicio. Consulta Administra productos de API.
  2. Registra desarrolladores de apps en Edge. Consulta Cómo registrar desarrolladores de apps.
  3. Registra apps y genera claves de API para tus desarrolladores. Consulta Registra apps y administra claves de API.
  4. Agrega políticas de seguridad a los proxies de API que verifican las claves de API o los tokens de seguridad. Consulta los siguientes temas:Verifica la política de clave de API, política de OAuthV2 y Verifica la política de JWT.
  5. Si usas Edge Microgateway, asegúrate de haber habilitado el complemento de estadísticas (que está habilitado de forma predeterminada). Si el complemento de estadísticas está inhabilitado, Edge Microgateway no enviará datos de estadísticas a las estadísticas de Edge.

Los siguientes instructivos te guiarán en los pasos necesarios para ver estadísticas de desarrolladores y apps: Protege una API mediante la solicitud de clave de API y Protege una API con OAuth.

Compara las estadísticas de la API con la supervisión de la API

Puedes aprovechar la supervisión de API de Edge y las estadísticas de API. La supervisión de API examina los datos de estadísticas para proporcionar estadísticas contextuales en tiempo real sobre el rendimiento de las API, lo que te permite diagnosticar problemas con rapidez y facilitar acciones para solucionar la continuidad del negocio. La supervisión de API se diseñó para encontrar rápidamente puntos de problemas en tus APIs y backends. Las estadísticas de API están diseñadas con el fin de capturar una amplia variedad de datos de estadísticas para que los usen varios equipos diferentes, pero, por lo general, los datos se usan a fin de realizar análisis en situaciones que no son en tiempo real.

Una de las principales diferencias entre API Monitoring y API Analytics es el mecanismo de alerta integrado en API Monitoring. Con las alertas, debes especificar un código de estado HTTP (2xx/4xx/5xx), latencia o umbral de código de falla que, cuando se supera, activa una notificación de alerta a tu equipo de operaciones. Las notificaciones de alerta se pueden enviar a través de una variedad de canales, como correo electrónico, Slack, localizadores o webhooks, lo que te permite responder a los problemas de inmediato.

Consulta Comparar la supervisión de la API con las estadísticas de la API de Edge para obtener una comparación más detallada entre estos servicios.

Más información