Les 12 indicateurs à surveiller pour une stratégie d’API réussie

Andrew Stiefel

À mesure que les entreprises adoptent des pratiques de conception API-first pour créer des applications modernes, mesurer les performances opérationnelles et la valeur de ces API devient une priorité absolue. La mise en place d’un cadre qui définit clairement les métriques des API et les relie aux indicateurs clés de performance (KPI) constitue l’une des étapes les plus importantes pour garantir la réussite d’une stratégie API.

En règle générale, les indicateurs clés de performance (KPI) sont liés à des objectifs précis. Ils s’inscrivent dans une période définie et correspondent aux résultats que votre stratégie d’API doit produire. À l’inverse, les métriques d’API sont des données significatives. Toutes les métriques ne sont pas des KPI, mais chaque KPI est initialement une métrique.

Alors, par où commencer ? Tout d’abord, vous devez définir clairement, dès le départ, l’objectif de votre stratégie d’API, puis choisir les indicateurs qui correspondent à cet objectif. N’oubliez pas que chaque équipe doit mesurer et suivre des indicateurs différents en fonction de ses priorités et de ce qui est essentiel pour l’entreprise.

De manière générale, les entreprises peuvent suivre trois grandes catégories d’indicateurs d’API, chacune répondant à une question différente :

• Indicateurs opérationnels – 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 produit – Comment les API contribuent-elles à vos objectifs commerciaux ?

Imaginez ces indicateurs globaux sous la forme d’une pyramide. À la base, les indicateurs opérationnels mesurent les performances tactiques de chaque API et de l’infrastructure qui les prend en charge. Au sommet, les indicateurs produit mesurent la valeur commerciale créée par vos API. Les deux sont reliés par des indicateurs d’adoption, qui suivent la croissance du programme d’API auprès des utilisateurs finaux (les développeurs). En règle générale, les indicateurs produit et d’adoption correspondent aux résultats commerciaux que vous devez mesurer, tandis que les indicateurs opérationnels correspondent aux normes techniques que vous devez respecter.

Dans cet article, nous présentons en détail 12 indicateurs spécifiques qu’il est essentiel de mesurer, expliquons comment ils aident les équipes chargées de l’infrastructure et des applications, et montrons de quelle manière ils sont liés aux KPI.

Indicateurs opérationnels

Lorsque vous débutez, les métriques opérationnelles sont généralement les premières données à mesurer. Elles sont de nature tactique et fournissent des informations sur le fonctionnement des API. Les métriques opérationnelles ne constituent généralement pas des KPI à proprement parler. Elles vous aident plutôt à mesurer la qualité et les performances des logiciels développés par vos équipes. Elles peuvent fournir des signes avant-coureurs de problèmes émergents ou vous aider à approfondir l’analyse afin d’identifier les problèmes susceptibles d’affecter vos KPI critiques.

Les métriques opérationnelles que vous suivez varient selon l’équipe et ses responsabilités.

Équipes d’infrastructure

Opérations de plateforme est l’équipe chargée de maintenir, de connecter et de sécuriser l’ensemble des infrastructures et des technologies utilisées par les différentes équipes pour fournir des applications. Pour les programmes d’API, cela comprend souvent les passerelles d’API et les portails pour développeurs d’API.

Les principaux indicateurs pour les équipes d’infrastructure telles que Platform Ops comprennent :

1. Disponibilité – Bien qu’il s’agisse de l’un des indicateurs les plus élémentaires, la disponibilité reste la référence absolue pour mesurer la disponibilité d’un service. Elle est souvent liée à 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 déterminer quand il peut être nécessaire d’augmenter le nombre de vos instances. Il sert également d’alerte précoce lorsqu’un dysfonctionnement commence à se produire ou que l’utilisation augmente brusquement en raison d’erreurs.
3. Taux globaux de réussite et d’erreur – Mesurer la fréquence à laquelle les API déclenchent des codes d’état d’erreur HTTP (autres que 200) vous aide à déterminer dans quelle mesure vos API sont susceptibles de générer des erreurs. Cette mesure agrégée fournit des informations permettant d’évaluer la qualité globale des API que vos équipes mettent en production.

Équipes applicatives

Les équipes applicatives, composées de développeurs d’API et de responsables de services, sont chargées de créer et d’exploiter des services ou des applications spécifiques. Ceux-ci peuvent être utilisés dans le cadre d’un produit plus vaste, pour assurer une intégration avec un partenaire ou pour fournir des API en tant que service aux développeurs.

Il est important que les équipes applicatives mesurent les indicateurs suivants :

1. Requêtes par minute – Cet indicateur de performance mesure le nombre de requêtes traitées par votre API. Bien qu’il varie au fil du temps, il est généralement préférable de chercher à le réduire afin de garantir la meilleure expérience possible aux utilisateurs de l’API.
2. Latence moyenne et maximale – Il est essentiel de mesurer le temps moyen nécessaire à votre API pour recevoir une requête et renvoyer une réponse. Une seule API lente peut nuire à l’expérience utilisateur et, par conséquent, avoir un impact négatif sur l’activité.
3. Erreurs par minute – Comme toute chose, aucune API n’est parfaite. Les défaillances sont inévitables tôt ou tard. Vous devez surveiller les erreurs et prévoir un plan d’action pour les corriger avant qu’elles ne commencent soudainement à se multiplier.

Plongez au cœur des opérations liées aux API et découvrez quels indicateurs clés de performance (KPI) et quelles métriques sont essentiels d’un point de vue métier dans les chapitres 3 à 5 de l’e-book « Maîtriser l’architecture des API » publié par O’Reilly et offert par NGINX.

Indicateurs d’adoption

Pour une entreprise axée sur les API, il est essentiel d’aller au-delà des indicateurs d’ingénierie et de comprendre comment les développeurs interagissent avec vos API. Vous devez également mesurer et surveiller l’expérience développeur liée aux API afin de vous assurer que les développeurs adoptent vos API et en tirent parti.

Voici quelques exemples d’indicateurs d’adoption :

1. Consommateurs uniques de l’API – Souvent calculée sur une base mensuelle, cette métrique mesure le nombre de développeurs qui adoptent et utilisent vos API. Idéalement, elle augmente au fil du temps à mesure que davantage de développeurs intègrent votre API à leurs applications.
2. Croissance de l’utilisation des API – Cet indicateur mesure également l’adoption des API et constitue souvent l’indicateur privilégié à cette fin. Idéalement, le trafic des API augmente chaque mois à mesure que le nombre d’applications et de développeurs qui les utilisent progresse.
3. Délai avant le premier appel – Cet indicateur mesure le temps nécessaire à un développeur pour créer un compte, générer des identifiants d’API et effectuer son premier appel d’API. Permettre aux développeurs d’être opérationnels le plus rapidement possible est une priorité absolue, ce qui en fait l’indicateur le plus important pour évaluer l’expérience globale des développeurs avec l’API.

Remarque : Nous vous recommandons de définir au moins un KPI visant à mesurer l’adoption de l’API. Cela permet d’évaluer la croissance globale de votre programme d’API. Par exemple, vous pouvez définir un KPI visant à augmenter le nombre de développeurs ayant créé une intégration pérenne ou une application à l’aide de votre API.

Indicateurs produit

Les indicateurs produit des API jouent un rôle majeur dans la compréhension de la valeur d’une API. Bien que seul un petit nombre d’API puissent contribuer directement au chiffre d’affaires, chaque API doit apporter de la valeur à l’entreprise.

Les principaux indicateurs produit à mesurer sont les suivants :

1. Revenus directs et indirects – Ces indicateurs mesurent les différentes manières dont les API contribuent au chiffre d’affaires. Si certaines API sont directement monétisées, d’autres permettent des intégrations avec des partenaires commerciaux ou constituent des intégrations tierces appréciées des clients. À l’instar du taux d’adoption de vos API, le suivi des revenus indirects aide les développeurs à créer pour les partenaires des applications génératrices de revenus.
2. Applications par API – Les API doivent être réutilisables. Cet indicateur mesure le nombre d’applications qui s’intègrent à une API afin de déterminer quelles API apportent le plus de valeur.
3. Nombre de partenaires – Les API facilitent souvent les relations commerciales. Le suivi du nombre d’intégrations d’API réalisées par des partenaires contribue à favoriser leur adoption et à démontrer leur valeur auprès des autres unités opérationnelles.

Remarque : Ces indicateurs produit sont étroitement liés à l’impact commercial, et vous pouvez choisir d’en convertir certains en KPI en fonction de vos objectifs commerciaux. Par exemple, si l’objectif commercial de votre stratégie d’API est d’atteindre davantage de clients par l’intermédiaire de fournisseurs tiers, vous devez suivre à la fois le nombre de partenaires qui utilisent vos API et les revenus indirects générés par ces intégrations.

Découvrez plus en détail le cycle de vie d’un produit API, notamment les KPI métier et opérationnels, dans les chapitres 3 à 5 de « Mastering API Architecture ».

Conclusion

L’alignement des métriques d’API sur les indicateurs clés de performance de l’entreprise constitue l’un des principaux moyens de prendre des décisions fondées sur les données et de garantir que votre stratégie d’API apporte la valeur dont votre organisation a besoin. Mais ce n’est pas tout : une meilleure visibilité sur vos API permet également aux équipes chargées de l’infrastructure et des applications de mesurer les métriques opérationnelles qui comptent le plus pour elles.

Chez NGINX, nous vous offrons une visibilité sur des dizaines de métriques d’API importantes. Vous pouvez consulter les métriques en temps réel et historiques, et les exporter facilement vers la solution de surveillance des performances applicatives (APM) ou d’analyse de données de votre choix.

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 d’API et à NGINX App Protect pour sécuriser vos API.

À propos de l’auteur

Andrew Stiefel

Autres articles de Andrew Stiefel