Quelles sont les 12 mesures à surveiller pour une stratégie API réussie

À mesure que les entreprises adoptent des pratiques de conception axées sur les API pour créer des applications modernes, mesurer les performances opérationnelles et la valeur de ces API devient une priorité absolue. L’établissement d’un cadre qui définit clairement et relie les métriques API aux indicateurs de performance clés (KPI) est l’une des étapes les plus importantes pour garantir une stratégie API réussie.

En règle générale, les KPI sont liés à des objectifs spécifiques. Ils ont un délai défini et sont alignés sur les résultats que votre stratégie API doit fournir. Les mesures API, en revanche, sont des points de données significatifs. Toutes les mesures ne sont pas des KPI, mais chaque KPI commence comme une mesure.

Alors, comment commencer ? Tout d’abord, vous devez être clair – dès le départ – sur l’objectif de votre stratégie API, puis choisir les métriques qui correspondent à cet objectif. N’oubliez pas que chaque équipe doit mesurer et suivre différentes mesures en fonction de ce qui est important pour elle et de ce qui est essentiel pour l’entreprise.

Il existe globalement trois principaux types de mesures API que les entreprises peuvent suivre, et chaque type répond à une question différente :

• Mesures opérationnelles : les API offrent-elles la stabilité, la fiabilité et les performances dont vous avez besoin ?
• Indicateurs d’adoption – Les développeurs adoptent-ils et utilisent-ils vos API ?
• Indicateurs de produit : comment les API soutiennent-elles vos objectifs commerciaux ?

Imaginez ces mesures globales comme une pyramide. En bas, les mesures opérationnelles mesurent les performances tactiques des API individuelles et de l’infrastructure qui les prend en charge. En haut, les mesures du produit mesurent la valeur commerciale créée par vos API. Les deux sont connectés par des mesures d’adoption, qui suivent la croissance du programme API auprès des utilisateurs finaux (développeurs). En règle générale, les mesures de produit et les mesures d’adoption s’alignent sur les résultats commerciaux que vous devez mesurer, tandis que les mesures opérationnelles s’alignent sur les normes techniques que vous devez maintenir.

Dans cet article, nous décomposons 12 mesures spécifiques qu'il est essentiel de mesurer, discutons de la manière dont elles permettent aux équipes d'infrastructure et d'application, et expliquons la manière dont les mesures sont liées aux KPI.

Indicateurs opérationnels

Lorsque vous débutez, les mesures opérationnelles sont généralement la première chose à mesurer. Ils sont tactiques et fournissent des informations sur le fonctionnement des API. Les indicateurs opérationnels ne sont généralement pas des indicateurs clés de performance (KPI). Au lieu de cela, ils vous aident à mesurer la qualité et les performances des logiciels que vos équipes créent. Ils peuvent fournir des indicateurs précoces de problèmes émergents ou vous aider à approfondir et à découvrir des problèmes susceptibles d'avoir un impact sur vos indicateurs clés de performance critiques.

Les mesures opérationnelles que vous suivez varient selon l’équipe et la responsabilité.

Équipes d'infrastructure

Platform Ops est l'équipe responsable de la maintenance, de la connexion et de la sécurisation de l'ensemble des infrastructures et des technologies utilisées par différentes équipes pour fournir des applications. Pour les programmes API, cela inclut souvent des passerelles API et des portails de développeurs API.

Les indicateurs clés pour les équipes d'infrastructure comme Platform Ops incluent :

1. Temps de disponibilité – Même s’il s’agit de l’une des mesures les plus élémentaires, le temps de disponibilité est la référence absolue pour mesurer la disponibilité d’un service. Cela est souvent lié à un accord de niveau de service (SLA).
2. Utilisation du processeur et de la mémoire – Le suivi de l’utilisation des ressources au niveau de la passerelle API est essentiel pour identifier le moment où vous pourriez avoir besoin de faire évoluer vos instances. Il agit également comme un avertissement précoce lorsque quelque chose commence à se casser ou que l'utilisation augmente en raison d'erreurs.
3. Taux de réussite et d’erreur totaux – Mesure de la fréquence à laquelle les API déclenchent des erreurs HTTP (non200 ) Les codes d’état vous aident à comprendre à quel point vos API peuvent être sujettes aux erreurs. Cette mesure globale fournit des informations pour aider à évaluer la qualité globale des API que vos équipes mettent en production.

Équipes d'application

Les équipes d’application, composées de développeurs d’API et de propriétaires de services, sont responsables de la création et de l’exploitation de services ou d’applications individuels. Ils peuvent être utilisés dans le cadre d'un produit plus vaste, pour s'intégrer à un partenaire ou lors de la fourniture d'API en tant que service aux développeurs.

Les indicateurs suivants sont importants à mesurer pour les équipes d’application :

4. Requêtes par minute – Cette mesure de performance mesure le nombre de requêtes traitées par votre API. Bien que cela varie au fil du temps, vous souhaitez généralement le gérer vers le bas pour garantir la meilleure expérience aux utilisateurs de l'API.
5. Latence moyenne et maximale – Il est essentiel de suivre le temps moyen nécessaire à votre API pour recevoir une demande et renvoyer une réponse. Une seule API lente peut avoir un impact négatif sur l’expérience utilisateur et donc sur l’entreprise.
6. Erreurs par minute – Comme tout le reste, aucune API n’est parfaite. Les échecs sont une question de quand, et non de si. Vous devez surveiller les erreurs et mettre en place un plan d’action pour les corriger avant qu’elles ne commencent soudainement à se produire.

Plongez dans les opérations API et découvrez quels indicateurs clés de performance et mesures sont essentiels d'un point de vue commercial dans les chapitres 3 à 5 de l'eBook Mastering API Architecture d'O'Reilly, avec les compliments de NGINX.

Indicateurs d'adoption

Pour une entreprise axée sur les API, il est essentiel de regarder au-delà des mesures d'ingénierie et de comprendre comment les développeurs interagissent avec vos API. Vous devez également mesurer et surveiller l’ expérience des développeurs d’API pour vous assurer qu’ils adoptent et tirent parti de vos API.

Voici quelques exemples de mesures d’adoption :

7. Consommateurs d’API uniques – Souvent limité dans le temps aux utilisateurs mensuels, cette mesure mesure le nombre de développeurs qui adoptent et utilisent vos API. Idéalement, cette mesure augmente au fil du temps à mesure que de plus en plus de développeurs intègrent votre API dans leurs applications.
8. Croissance de l’utilisation des API – Cette mesure mesure également l’adoption des API et est souvent la mesure préférée pour le faire. Idéalement, le trafic API augmente chaque mois à mesure que le nombre d’applications et de développeurs qui les utilisent augmente également.
9. Délai jusqu'au premier appel – Cette mesure mesure le temps qu'il faut à un développeur pour créer un compte, générer des informations d'identification d'API et exécuter le premier appel d'API. Permettre aux développeurs d'être opérationnels le plus rapidement possible est une priorité absolue, ce qui fait de cette mesure la plus importante pour mesurer l'expérience globale du développeur d'API.

Note: Nous vous recommandons qu’au moins un de vos KPI cherche à mesurer l’adoption des API. Cela permet de calculer la croissance globale de votre programme API. Par exemple, vous pouvez définir un KPI pour augmenter le nombre de développeurs qui ont créé une intégration ou une application en cours à l'aide de votre API.

Mesures du produit

Les indicateurs de produit API jouent un rôle majeur dans la compréhension de la valeur d'une API. Même si seul un petit sous-ensemble d'API peut contribuer directement au chiffre d'affaires, chaque API doit apporter de la valeur à l'entreprise.

Les principaux indicateurs de produit à mesurer comprennent :

10. Revenus directs et indirects – Ces mesures ciblent les différentes manières dont les API contribuent aux revenus. Alors que certaines API sont directement monétisées, d’autres prennent en charge les intégrations avec des partenaires commerciaux ou sont des intégrations tierces appréciées des clients. Tout comme le taux d’adoption de vos API, le suivi des revenus indirects aide les développeurs à créer des applications génératrices de revenus pour les partenaires.
11. Applications par API – Les API doivent être réutilisables. Cette mesure évalue le nombre d'applications qui s'intègrent à une API pour voir quelles API offrent le plus de valeur.
12. Nombre de partenaires – Les API permettent souvent des relations commerciales. Le suivi du nombre d’intégrations d’API partenaires contribue à stimuler l’adoption et à démontrer la valeur aux autres unités commerciales.

Note: Ces mesures de produit correspondent étroitement à l’impact commercial, et vous pouvez choisir d’en transformer certaines en indicateurs clés de performance en fonction de vos objectifs commerciaux. Par exemple, si l’objectif commercial de votre stratégie API est d’atteindre davantage de clients via des fournisseurs tiers, vous souhaitez suivre à la fois le nombre de partenaires utilisant vos API et les revenus indirects générés par ces intégrations.

Explorez le cycle de vie du produit API, y compris les indicateurs clés de performance opérationnels et commerciaux, plus en détail dans les chapitres 3 à 5 de Mastering API Architecture .

Conclusion

L’alignement des métriques API et des indicateurs clés de performance de l’entreprise est l’un des principaux moyens de prendre des décisions basées sur les données et de garantir que votre stratégie API offre la valeur dont votre organisation a besoin. Et ce n’est pas tout : gagner en visibilité sur vos API peut également permettre aux équipes d’infrastructure et d’application de mesurer les indicateurs opérationnels qui comptent le plus pour elles.

Chez NGINX, nous offrons une visibilité sur des dizaines de mesures API importantes. Vous pouvez afficher des mesures en temps réel et historiques, et les exporter facilement vers votre solution de surveillance des performances des applications (APM) ou d'analyse de données préférée.

Commencez dès aujourd’hui avec un essai gratuit de 30 jours de NGINX Management Suite , qui comprend l’accès à API Connectivity Manager , NGINX Plus en tant que passerelle API et NGINX App Protect pour sécuriser vos API.