Qué 12 métricas monitorizar para lograr una estrategia de API exitosa

NGINX | 17 de enero de 2023

A medida que las empresas adoptan prácticas de diseño «API-first» para crear aplicaciones modernas, medir el rendimiento operativo y el valor de esas API se convierte en una prioridad absoluta. Establecer un marco que defina claramente y vincule las métricas de las API con los indicadores clave de rendimiento (KPI) es uno de los pasos más importantes para garantizar el éxito de una estrategia de API.

Normalmente, los KPI están vinculados a objetivos específicos. Tienen un plazo definido y están alineados con los resultados que debe ofrecer su estrategia de API. En cambio, las métricas de API son datos relevantes. No todas las métricas son KPI, pero todos los KPI comienzan siendo una métrica.

Entonces, ¿por dónde empezar? En primer lugar, debes tener claro desde el principio cuál es el objetivo de tu estrategia de API y, a continuación, elegir las métricas que se ajusten a dicho objetivo. Recuerda que cada equipo debe medir y supervisar distintas métricas en función de lo que sea importante para él y de lo que resulte esencial para el negocio.

En términos generales, existen tres grandes tipos de métricas de API que las empresas pueden monitorizar, y cada uno responde a una pregunta diferente:

Métricas operativas – ¿Las API ofrecen la estabilidad, la fiabilidad y el rendimiento que necesita?
Métricas de adopción – ¿Los desarrolladores están adoptando y utilizando tus API?
Métricas de producto – ¿Cómo contribuyen las API a alcanzar los objetivos de tu empresa?

Imagine estas métricas generales como una pirámide. En la base, las métricas operativas miden el rendimiento táctico de cada API y de la infraestructura que las sustenta. En la cúspide, las métricas de producto miden el valor empresarial generado por sus API. Ambas están conectadas por las métricas de adopción, que realizan un seguimiento del crecimiento del programa de API entre los usuarios finales (desarrolladores). Por lo general, las métricas de producto y de adopción se corresponden con los resultados empresariales que necesita medir, mientras que las métricas operativas se ajustan a los estándares técnicos que debe mantener.

En este artículo, analizamos 12 métricas específicas que es fundamental medir, explicamos cómo ayudan a los equipos de infraestructura y aplicaciones, y detallamos su relación con los KPI.

Métricas operativas

Cuando se está empezando, las métricas operativas suelen ser lo primero que se mide. Son de carácter táctico y ofrecen información sobre el funcionamiento de las API. Por lo general, las métricas operativas no son KPI en sí mismas. En cambio, ayudan a medir la calidad y el rendimiento del software que desarrollan los equipos. Pueden proporcionar indicios tempranos de problemas emergentes o ayudar a profundizar en los datos y detectar problemas que podrían estar afectando a los KPI críticos.

Las métricas operativas que supervise variarán según el equipo y sus responsabilidades.

Equipos de infraestructura

Operaciones de Plataforma es el equipo responsable de mantener, conectar y proteger el conjunto de infraestructuras y tecnologías que utilizan distintos equipos para desplegar aplicaciones. En los programas de API, esto suele incluir puertas de enlace de API y portales para desarrolladores de API.

Las métricas clave para los equipos de infraestructura, como Platform Ops, incluyen:

Tiempo de actividad – Aunque es una de las métricas más básicas, el tiempo de actividad es el estándar de referencia para medir la disponibilidad de un servicio. Suele estar vinculado a un acuerdo de nivel de servicio (SLA).
Uso de CPU y memoria – Supervisar el uso de recursos en la puerta de enlace de API es fundamental para determinar cuándo puede ser necesario ampliar el número de instancias. También sirve como alerta temprana cuando algo empieza a fallar o el uso se dispara debido a errores.
Tasas totales de éxito y error – Medir la frecuencia con la que las API generan códigos de estado de error HTTP (distintos de 200) ayuda a comprender hasta qué punto sus API pueden ser propensas a errores. Esta medida agregada proporciona información para evaluar la calidad general de las API que sus equipos ponen en producción.

Equipos de aplicaciones

Los equipos de aplicaciones, formados por desarrolladores de API y responsables de servicios, se encargan de crear y operar servicios o aplicaciones individuales. Estos pueden utilizarse como parte de un producto más amplio, para integrarse con un socio o para ofrecer API como servicio a los desarrolladores.

Es importante que los equipos de aplicaciones midan las siguientes métricas:

Solicitudes por minuto – Esta métrica de rendimiento mide el número de solicitudes que gestiona tu API. Aunque varía con el tiempo, normalmente conviene reducirlo para garantizar la mejor experiencia a los usuarios de la API.
Latencia media y máxima – Es fundamental hacer un seguimiento del tiempo medio que tarda la API en recibir una solicitud y devolver una respuesta. Una sola API lenta puede afectar negativamente a la experiencia del usuario y, por tanto, al negocio.
Errores por minuto – Como todo lo demás, ninguna API es perfecta. Los fallos no son una cuestión de si ocurrirán, sino de cuándo. Debes supervisar los errores y contar con un plan de acción para corregirlos antes de que empiecen a aumentar repentinamente.

Profundiza en las operaciones de las API y descubre qué KPI y métricas son fundamentales desde una perspectiva empresarial en los capítulos 3–5 del libro electrónico «Dominar la arquitectura de las API» de O’Reilly, cortesía de NGINX.

Métricas de adopción

Para una empresa que prioriza las API, es fundamental ir más allá de las métricas de ingeniería y comprender cómo interactúan los desarrolladores con sus API. También es necesario medir y supervisar la experiencia de los desarrolladores con las API para garantizar que las adopten y obtengan valor de ellas.

Algunos ejemplos de métricas de adopción son:

Consumidores únicos de la API – A menudo se mide por periodos, como usuarios mensuales. Esta métrica indica cuántos desarrolladores adoptan y utilizan tus API. Lo ideal es que aumente con el tiempo a medida que más desarrolladores integren tu API en sus aplicaciones.
Crecimiento del uso de la API – Esta métrica también mide la adopción de la API y suele ser la opción preferida para ello. Lo ideal es que el tráfico de la API aumente cada mes a medida que también crece el número de aplicaciones y desarrolladores que la utilizan.
Tiempo hasta la primera llamada – Esta métrica mide cuánto tarda un desarrollador en crear una cuenta, generar credenciales de API y realizar la primera llamada a la API. Facilitar que los desarrolladores puedan empezar a trabajar lo antes posible es una prioridad, por lo que esta es la métrica más importante para evaluar la experiencia general de los desarrolladores con la API.

Nota: Recomendamos que al menos uno de sus KPI mida la adopción de la API. Esto ayuda a calcular el crecimiento general de su programa de API. Por ejemplo, podría establecer un KPI para aumentar el número de desarrolladores que han creado una integración continua o una aplicación utilizando su API.

Métricas del producto

Las métricas de producto de las API desempeñan un papel fundamental a la hora de comprender el valor de una API. Aunque solo un pequeño subconjunto de API puede contribuir directamente a los ingresos, todas las API deben aportar valor al negocio.

Las principales métricas de producto que se deben medir incluyen:

Ingresos directos e indirectos – Estas métricas abarcan las distintas formas en que las API contribuyen a generar ingresos. Mientras que algunas API se monetizan directamente, otras permiten integraciones con socios comerciales o son integraciones de terceros que los clientes valoran. Al igual que ocurre con la tasa de adopción de las API, hacer un seguimiento de los ingresos indirectos ayuda a los desarrolladores a crear aplicaciones que generen ingresos para los socios.
Aplicaciones por API – Las API deben ser reutilizables. Esta métrica mide cuántas aplicaciones se integran con una API para determinar qué API aportan más valor.
Número de socios – Las API suelen facilitar las relaciones comerciales. Hacer un seguimiento del número de integraciones de API con socios ayuda a impulsar la adopción y a demostrar su valor a otras unidades de negocio.

Nota: Estas métricas de producto están estrechamente relacionadas con el impacto empresarial, y puede que decidas convertir algunas de ellas en KPI en función de tus objetivos de negocio. Por ejemplo, si el objetivo empresarial de tu estrategia de API es llegar a más clientes a través de proveedores externos, te interesará hacer un seguimiento tanto del número de socios que utilizan tus API como de los ingresos indirectos generados mediante esas integraciones.

Profundiza en el ciclo de vida de los productos de API —incluidos los KPI empresariales y operativos— en los capítulos 3 a 5 de «Mastering API Architecture».

Conclusión

Alinear las métricas de las API con los KPI empresariales es una de las principales formas de tomar decisiones basadas en datos y garantizar que su estrategia de API aporte el valor que su organización necesita. Y no solo eso: obtener visibilidad sobre sus API también permite a los equipos de infraestructura y aplicaciones medir las métricas operativas que más les importan.

En NGINX, ofrecemos visibilidad sobre decenas de métricas importantes de las API. Puede consultar métricas históricas y en tiempo real, y exportarlas fácilmente a su solución preferida de monitorización del rendimiento de aplicaciones (APM) o de análisis de datos.

Empiece hoy mismo con una prueba gratuita de 30 días de NGINX Management Suite, que incluye acceso a API Connectivity Manager, NGINX Plus como puerta de enlace de API y a NGINX App Protect para proteger sus API.