Descripción general de Apigee Analytics

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

En este tema, se presenta Apigee Analytics.

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

Mejora tu API a través de estadísticas

Las estadísticas de Apigee recopilan y calculan una gran cantidad de información que fluye a través de proxies de API. Puedes visualizar estos datos con grafos y gráficos en la IU de Apigee o puedes descargar los datos sin procesar para un análisis sin conexión mediante las API de Apigee.

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?
  • ¿Cuántos ingresos generaron tus transacciones?

Puedes analizar los datos de un nombre de host específico o de un entorno completo.

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 ayudan a todos a mejorar

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

Los datos fluyen desde las apps a través de proxies de API y, luego, el análisis de datos ayuda a guiar las acciones de los desarrolladores de apps, los equipos de API, los equipos de operaciones y los propietarios de las empresas.
  • 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?

Las estadísticas de la API de Apigee recopilan y analizan un amplio espectro 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
  • Ingresos por transacciones

Para obtener una lista completa de los datos que recopilan las estadísticas de la API, consulta Referencia de métricas, dimensiones y filtros de Analytics.

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

Apigee recopila de forma nativa una gran cantidad de datos. 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.

Para recopilar datos de estadísticas personalizadas, usa Recopilar datos de estadísticas personalizadas y usa la IU de estadísticas o la API para examinar los datos. 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.

¿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 de datos: Después de hacer una llamada a un proxy de API, pueden transcurrir hasta 10 minutos para poder acceder a los datos y poder visualizarlos o mostrarlos a través de llamadas a la API.
  • Disponibilidad de estadísticas: El tiempo que Apigee proporciona los datos de estadísticas (incluidos los datos de Monetization y Sense, si corresponde) varía según el plan. Según tu plan, los datos de estadísticas pueden estar disponibles para los últimos 30 días, 90 días o 14 meses.

¿Dónde se almacenan mis datos de estadísticas?

Definiste la ubicación de tus datos de estadísticas cuando instalaste Apigee o Apigee Hybrid. Las ubicaciones válidas son un subconjunto de las regiones de Compute Engine enumeradas en el Paso 1: Selecciona tu proyecto.

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

Apigee Analytics proporciona herramientas de visualización de datos integradas en la IU de Apigee. 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 Apigee. 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 Apigee proporciona un conjunto de paneles predefinidos que puedes usar para ver los datos de estadísticas. Por ejemplo, las siguientes imágenes muestran el panel Rendimiento del proxy de API:

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

  • Tráfico total: La cantidad total de solicitudes a la API que recibió Apigee para un entorno de API en 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 cualquiera de los datos de estadísticas integrados en Apigee.

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, consulta Crea y administra informes personalizados.

API de Analytics

Usa la API de Apigee 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://apigee.googleapis.com/v1/organizations/myorg/environments/test/stats/apiproxy?"select=sum(message_count)&timeRange=6/24/20120%2000:00~6/24/2020%2023:59&timeUnit=hour" \
  -X POST \
  -H "Authorization: Bearer $TOKEN"

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 la sección sobre cómo usar la API de métricas.

Exporta datos de estadísticas a GCP

Puedes usar la API de Apigee para exportar todos los datos de estadísticas de un día entero de Apigee 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 la sección sobre cómo exportar datos desde estadísticas.

¿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.

Las apps envían datos a través de proxies de API y, a continuación, el análisis de los datos ayuda a un desarrollador de apps a comprender su rendimiento.

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 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á arriba o abajo 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 Supervisa apps en la documentación de Drupal 8.

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

  • Crear informes personalizados y compartirlos con tus desarrolladores de app Para obtener más información, consulta Crea y administra informes personalizados.
  • Usar las API de métricas para capturar datos de un período más amplio y compartirlos con desarrolladores de apps sin conexión. Para obtener más información, consulta Usa la API de métricas.

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

¿Qué queremos decir con estadísticas completas? Por ejemplo, puedes crear un proxy de API y Apigee 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 Apigee no sabe quién hizo una llamada a la API, no puede recopilar esos datos.

Debes seguir algunos pasos para que Apigee sepa qué desarrolladores y qué apps de desarrollador llaman a tus 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 con Apigee. Consulta Registra desarrolladores de apps.
  3. Registra apps y administra las 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: Política VerifyAPIKey, Política de OAuthV2 y Política VerifyJWT.

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.

Más información