12 Überwachungsmetriken, um sicherzustellen, dass Ihre API-Strategie erfolgreich ist

Das Open-Source-Community-Team China machte seine erste Live-Übertragung und erzählte im Namen des Teilens die Geschichte hinter der Open-Source-Community China.“

Ursprünglicher Autor: Andrew Stiefel von F5

Ursprünglicher Link: 12 Überwachungsindikatoren für eine erfolgreiche API-Strategie

Nachdruckquelle: NGINX Open Source Community

Die einzige offizielle chinesische Community von NGINX, alle unter nginx.org.cn

Da Unternehmen bei der Erstellung moderner Anwendungen API-First- Designpraktiken übernehmen, ist die Messung der Betriebsleistung und des Werts dieser APIs unerlässlich geworden. Der Aufbau eines Frameworks, das API-Metriken klar definiert und sie mit Key Performance Indicators (KPIs) verknüpft, ist einer der wichtigsten Schritte zur Gewährleistung einer erfolgreichen API-Strategie.

Typischerweise sind KPIs eng mit bestimmten Zielen verknüpft. Sie haben klare Zeitrahmen und entsprechen den Anforderungen der API-Strategie. Im Gegensatz dazu sind API-Metriken wichtige Datenpunkte. Nicht alle Kennzahlen sind KPIs, aber jeder KPI basiert auf Kennzahlen.

Wie sollten Sie also vorgehen? Zunächst müssen Sie das Ziel Ihrer API-Strategie von Anfang an klären und dann die Metriken auswählen, die diesem Ziel entsprechen. Denken Sie daran, dass jedes Team unterschiedliche Kennzahlen messen und verfolgen muss, je nachdem, was für es wichtig und für das Unternehmen notwendig ist.

Im Großen und Ganzen gibt es drei große Kategorien von API-Metriken, die Unternehmen verfolgen können, und verschiedene Kategorien von Metriken spiegeln unterschiedliche Probleme wider:

Betriebsmetriken – Bietet die API die Stabilität, Zuverlässigkeit und Leistung, die Sie benötigen?
Akzeptanzmetriken – Übernehmen Entwickler Ihre API?
Produktmetriken – Wie unterstützt die API Ihre Geschäftsziele?

Sie können sich diese drei großen Kategorien von Indikatoren als Pyramide vorstellen. Die Betriebsmetriken unten messen die taktische Leistung einzelner APIs und ihrer unterstützenden Infrastruktur. Die wichtigsten Produktkennzahlen messen den durch die API geschaffenen Geschäftswert. Die beiden sind durch Akzeptanzmetriken miteinander verbunden, die das Wachstum von API-Programmen bei Endbenutzern (Entwicklern) verfolgen. Im Allgemeinen beziehen sich Produktkennzahlen und Akzeptanzkennzahlen auf die Geschäftsergebnisse, die Sie messen müssen, während sich Betriebskennzahlen auf die technischen Standards beziehen, die Sie einhalten müssen.

In diesem Artikel werden 12 spezifische Metriken aufgeschlüsselt, die gemessen werden müssen, beschrieben, wie sie Infrastruktur- und Anwendungsteams unterstützen, und erklärt, wie diese Metriken mit KPIs zusammenhängen.

Betriebs- und Wartungsanzeigen

In der Anfangsphase sind betriebliche Kennzahlen oft die ersten Kennzahlen, die gemessen werden. Dabei handelt es sich um taktische Kennzahlen, die Aufschluss über die Leistung Ihrer API geben. Operative Indikatoren sind in der Regel keine KPIs. Sie können Ihnen jedoch dabei helfen, die Qualität und Leistung der von Ihrem Team erstellten Software zu messen und Frühindikatoren für neue Probleme zu liefern. Sie können Ihnen aber auch dabei helfen, tiefer in die Materie einzudringen und Probleme aufzudecken, die sich auf wichtige KPIs auswirken können.

Sie können verschiedene Betriebskennzahlen basierend auf Team und Verantwortung verfolgen.

Infrastrukturteam

Das Platform Operations- Team pflegt, verbindet und sichert die Infrastruktur und das Technologieportfolio, die von verschiedenen Teams zur Bereitstellung von Anwendungen verwendet werden. Im Falle von API-Programmen umfasst dies typischerweise API-Gateways und API-Entwicklerportale.

Zu den wichtigsten Kennzahlen für Infrastrukturteams wie Plattformbetrieb gehören:

Betriebszeit – Auch wenn es sich um eine der grundlegendsten Kennzahlen handelt, ist die Betriebszeit der Goldstandard für die Messung der Serviceverfügbarkeit. Es ist oft mit einem Service Level Agreement (SLA) verbunden.
CPU- und Speichernutzung – Die Verfolgung der Ressourcennutzung Ihres API-Gateways ist entscheidend, um zu bestimmen, wann Sie Ihre Instanz möglicherweise skalieren müssen. Es kann auch als Frühwarnindikator für einen bevorstehenden Ausfall oder einen fehlerbedingten Anstieg der Nutzung dienen.
Gesamterfolgs- und Fehlerraten : Wenn Sie messen, wie oft eine API einen HTTP-Fehlerstatuscode (nicht 200) auslöst, können Sie besser verstehen, wie fehleranfällig Ihre API ist. Diese zusammengesetzte Metrik liefert Informationen, die Ihnen helfen, die Gesamtqualität der APIs zu beurteilen, die Ihr Team in die Produktion bringt.

Bewerbungsteam

Das Anwendungsteam besteht aus API-Entwicklern und Dienstbesitzern, die für die Erstellung und den Betrieb jedes Dienstes oder jeder Anwendung verantwortlich sind. Diese Dienste oder Anwendungen können als Teil eines größeren Produkts verwendet, in Partnerprodukte integriert oder zur Bereitstellung von APIs als Dienst für Entwickler verwendet werden.

Anwendungsteams müssen die folgenden Kennzahlen messen:

Anfragen pro Minute – Diese Leistungsmetrik misst die Anzahl der Anfragen, die Ihre API pro Minute verarbeitet. Obwohl es sich im Laufe der Zeit ändert, möchten Sie im Allgemeinen die Anzahl der Anfragen pro Minute begrenzen, um Ihren API-Benutzern das beste Erlebnis zu bieten.
Durchschnittliche und maximale Latenz – Es ist wichtig, die durchschnittliche Zeit zu verfolgen, die Ihre API benötigt, um eine Anfrage zu empfangen und eine Antwort zurückzugeben. Langsame APIs können sich negativ auf die Benutzererfahrung auswirken, was wiederum negative Auswirkungen auf das Geschäft haben kann.
Fehler pro Minute – Die Wahrheit ist oft dieselbe: Es gibt keine perfekte API. Fehler sind früher oder später unvermeidlich. Sie müssen Fehler überwachen und eine gut geplante Vorgehensweise umsetzen, um sie so schnell wie möglich zu beheben, bevor sie plötzlich eskalieren.

In den Kapiteln 3–5 des O'Reilly-E-Books Mastering API Architecture von NGINX finden Sie ein tieferes Verständnis der API-Operationen sowie der KPIs und Metriken, die für Ihr Unternehmen von entscheidender Bedeutung sind.

Akzeptanzkennzahlen

API-orientierte Unternehmen sollten über technische Kennzahlen hinausblicken, um zu verstehen, wie Entwickler mit Ihren APIs interagieren. Sie müssen auch die Erfahrung der API-Entwickler messen und überwachen , um sicherzustellen, dass Entwickler Ihre API übernehmen und einen Nutzen daraus ziehen.

Hier einige Beispiele für die Verwendung von Indikatoren:

Einzigartige API-Konsumenten – Diese Metrik misst normalerweise anhand der Anzahl der monatlich aktiven Benutzer, wie viele Entwickler Ihre API verwenden. Im Idealfall wächst diese Kennzahl, wenn mehr Entwickler Ihre API in ihre Anwendungen integrieren.
Wachstum der API-Nutzung – Diese Kennzahl misst auch die API-Einführung und ist häufig die bevorzugte Kennzahl zur Messung der API-Einführung. Im Idealfall wächst der API-Verkehr von Monat zu Monat, da immer mehr Anwendungen und Entwickler die API nutzen.
Zeit bis zum ersten Aufruf – Diese Kennzahl misst die Zeit, die ein Entwickler benötigt, um ein Konto zu erstellen, API-Anmeldeinformationen zu generieren und den ersten API-Aufruf auszuführen. Es hat höchste Priorität, Entwickler so schnell wie möglich zum Laufen zu bringen, daher ist diese Kennzahl die wichtigste Kennzahl für die gesamte API-Entwicklererfahrung.

Hinweis: Wir empfehlen, mindestens einen KPI zur Messung der API-Einführung zu haben. Dies hilft Ihnen, das Gesamtwachstum Ihres API-Programms abzuschätzen. Sie könnten beispielsweise einen KPI einrichten, um das Wachstum der Anzahl der Entwickler zu verfolgen, die Ihre API zum Erstellen kontinuierlicher Integrationen oder Apps verwenden.

Produktindikatoren

API-Produktmetriken spielen eine wichtige Rolle dabei, den Wert Ihrer API zu verstehen. Während nur eine kleine Teilmenge der APIs einen direkten Umsatzbeitrag leisten kann, muss jede API einen Mehrwert für das Unternehmen schaffen.

Zu den wichtigsten zu messenden Produktkennzahlen gehören:

Direkter und indirekter Umsatz – Diese Kennzahlen messen die unterschiedliche Art und Weise, wie APIs zum Umsatz beitragen. Einige dieser APIs sind direkt monetarisierbar, andere unterstützen die Integration mit Produkten von Geschäftspartnern oder Integrationen von Drittanbietern, die für Kunden von entscheidender Bedeutung sind. Ebenso wie die Verfolgung der API-Einführung hilft die Verfolgung indirekter Einnahmen Entwicklern, umsatzgenerierende Anwendungen für Partner zu entwickeln.
Anzahl der Anwendungen pro API – APIs müssen wiederverwendbar sein. Diese Metrik misst, wie viele Anwendungen in die API integriert sind, um zu verstehen, welche APIs den größten Mehrwert schaffen.
Anzahl der Partner – APIs ermöglichen häufig den Aufbau von Geschäftsbeziehungen. Die Verfolgung der Anzahl der API-Integrationen eines Partners kann dazu beitragen, die Akzeptanz zu steigern und den Wert für andere Geschäftsbereiche zu demonstrieren.

Hinweis: Diese Produktindikatoren stehen in engem Zusammenhang mit den Geschäftsauswirkungen. Sie können einige Produktindikatoren basierend auf Ihren Geschäftszielen in KPIs umwandeln. Wenn das Geschäftsziel Ihrer API-Strategie beispielsweise darin besteht, mehr Kunden über einen Drittanbieter zu erreichen, können Sie die Anzahl der Partner, die Ihre API nutzen, und die durch diese Integrationen generierten indirekten Einnahmen verfolgen.

Weitere Informationen zum Lebenszyklus von API-Produkten, einschließlich Geschäfts- und Betriebs-KPIs, finden Sie in den Kapiteln 3–5 von „API-Architektur beherrschen“ .

Abschluss

Die Korrelation von API-Metriken mit Geschäfts-KPIs ist eine der wichtigsten Möglichkeiten für Unternehmen, datengesteuerte Entscheidungen zu treffen und sicherzustellen, dass ihre API-Strategie den benötigten Wert liefert. Darüber hinaus hilft die Aktivierung der API-Sichtbarkeit den Infrastruktur- und Anwendungsteams dabei, die für jeden einzelnen wichtigsten Betriebsmetriken zu messen.

NGINX ermöglicht die Visualisierung Dutzender wichtiger API-Indikatoren. Sie können Echtzeit- und Verlaufsmetriken anzeigen und diese problemlos in Ihre bevorzugte Anwendungsleistungsüberwachung (oder APM) oder Datenanalyselösung exportieren.

Die einzige offizielle chinesische Community von NGINX, alle unter nginx.org.cn

Weitere technische Informationen zu NGINX, interaktive Fragen und Antworten, Kursreihen und Veranstaltungsressourcen: Offizielle Website der Open Source Community |