Diese 12 Kennzahlen sollten Sie für eine erfolgreiche API-Strategie überwachen

NGINX | 17. Januar 2023

Da Unternehmen zunehmend auf API‑first-Designpraktiken setzen, um moderne Anwendungen zu entwickeln, wird die Messung der betrieblichen Leistung und des Nutzens dieser APIs zu einer der wichtigsten Aufgaben. Die Einrichtung eines Frameworks, das API-Metriken klar definiert und mit zentralen Leistungskennzahlen (KPIs) verknüpft, ist einer der wichtigsten Schritte für eine erfolgreiche API-Strategie.

In der Regel sind KPIs an bestimmte Ziele geknüpft. Sie beziehen sich auf einen festgelegten Zeitraum und sind auf die Ergebnisse abgestimmt, die mit Ihrer API-Strategie erzielt werden sollen. API-Metriken hingegen sind aussagekräftige Datenpunkte. Nicht jede Metrik ist ein KPI, aber jeder KPI beginnt als Metrik.

Wie fangen Sie also an? Zunächst müssen Sie sich von Anfang an über das Ziel Ihrer API-Strategie im Klaren sein und dann die Kennzahlen auswählen, die auf dieses Ziel abgestimmt sind. Denken Sie daran, dass jedes Team unterschiedliche Kennzahlen messen und verfolgen muss – je nachdem, was für das Team wichtig und für das Unternehmen entscheidend ist.

Im Großen und Ganzen gibt es drei übergeordnete Arten von API-Kennzahlen, die Unternehmen erfassen können, wobei jede Art eine andere Frage beantwortet:

Betriebsmetriken – Bieten die APIs die erforderliche Stabilität, Zuverlässigkeit und Leistung?
Akzeptanzmetriken – Werden Ihre APIs von Entwicklern angenommen und genutzt?
Produktkennzahlen – Wie unterstützen APIs Ihre Geschäftsziele?

Stellen Sie sich diese übergeordneten Kennzahlen als Pyramide vor. An der Basis messen operative Kennzahlen die taktische Leistung einzelner APIs und der sie unterstützenden Infrastruktur. An der Spitze messen Produktkennzahlen den durch Ihre APIs geschaffenen Geschäftswert. Beide Ebenen sind durch Akzeptanzkennzahlen miteinander verbunden, die das Wachstum des API-Programms bei den Endnutzern (Entwicklern) erfassen. Im Allgemeinen orientieren sich Produkt- und Akzeptanzkennzahlen an den Geschäftsergebnissen, die Sie messen müssen, während operative Kennzahlen auf die technischen Standards ausgerichtet sind, die Sie einhalten müssen.

In diesem Beitrag stellen wir 12 konkrete Kennzahlen vor, deren Messung von entscheidender Bedeutung ist. Wir erläutern, wie sie Infrastruktur- und Anwendungsteams unterstützen und in welcher Beziehung sie zu KPIs stehen.

Betriebsmetriken

Wenn Sie gerade erst anfangen, sind Betriebskennzahlen in der Regel das Erste, was Sie messen sollten. Sie sind taktischer Natur und geben Aufschluss darüber, wie APIs funktionieren. Betriebskennzahlen sind normalerweise keine eigenständigen KPIs. Stattdessen helfen sie Ihnen, die Qualität und Leistung der von Ihren Teams entwickelten Software zu messen. Sie können frühzeitig auf sich abzeichnende Probleme hinweisen oder Ihnen helfen, tiefergehende Analysen durchzuführen und Probleme zu erkennen, die sich möglicherweise auf Ihre entscheidenden KPIs auswirken.

Welche operativen Kennzahlen Sie verfolgen, hängt vom jeweiligen Team und dessen Verantwortungsbereich ab.

Infrastrukturteams

Platformbetrieb ist das Team, das für die Wartung, Vernetzung und Absicherung der Infrastruktur und Technologien verantwortlich ist, die von verschiedenen Teams zur Bereitstellung von Anwendungen genutzt werden. Bei API-Programmen umfasst dies häufig API-Gateways und API-Entwicklerportale.

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

Verfügbarkeit – Obwohl sie zu den grundlegendsten Kennzahlen zählt, gilt die Verfügbarkeit als Goldstandard für die Messung der Verfügbarkeit eines Dienstes. Sie ist häufig an eine Service-Level-Vereinbarung (SLA) gekoppelt.
CPU- und Arbeitsspeicherauslastung – Die Überwachung der Ressourcenauslastung am API-Gateway ist entscheidend, um zu erkennen, wann Sie Ihre Instanzen horizontal skalieren müssen. Sie dient außerdem als Frühwarnsystem, wenn erste Störungen auftreten oder die Auslastung aufgrund von Fehlern sprunghaft ansteigt.
Gesamterfolgs- und Gesamtfehlerraten – Indem Sie messen, wie häufig APIs HTTP-Fehlerstatuscodes (ungleich 200) auslösen, können Sie besser einschätzen, wie fehleranfällig Ihre APIs sind. Diese aggregierte Kennzahl liefert Informationen, anhand derer Sie die Gesamtqualität der APIs beurteilen können, die Ihre Teams in die Produktion überführen.

Anwendungsteams

Anwendungsteams, die sich aus API-Entwicklern und Serviceverantwortlichen zusammensetzen, sind für die Entwicklung und den Betrieb einzelner Services oder Anwendungen verantwortlich. Diese können als Teil eines größeren Produkts, zur Integration mit einem Partner oder bei der Bereitstellung von APIs als Service für Entwickler eingesetzt werden.

Für Anwendungsteams ist es wichtig, die folgenden Kennzahlen zu messen:

Anfragen pro Minute – Diese Leistungskennzahl misst die Anzahl der Anfragen, die Ihre API verarbeitet. Auch wenn sie im Laufe der Zeit schwankt, sollten Sie in der Regel darauf hinwirken, sie zu reduzieren, um API-Nutzern die bestmögliche Erfahrung zu bieten.
Durchschnittliche und maximale Latenz – Es ist entscheidend, die durchschnittliche Zeit zu erfassen, die Ihre API benötigt, um eine Anfrage zu empfangen und eine Antwort zurückzugeben. Bereits eine einzige langsame API kann die Benutzererfahrung und damit auch das Geschäft beeinträchtigen.
Fehler pro Minute – Wie alles andere ist auch keine API perfekt. Ausfälle sind keine Frage des Ob, sondern des Wann. Sie müssen Fehler überwachen und einen Maßnahmenplan für deren Behebung bereithalten, bevor ihre Zahl plötzlich ansteigt.

Tauchen Sie tief in den API-Betrieb ein und erfahren Sie in den Kapiteln 3–5 des E-Books, welche KPIs und Metriken aus geschäftlicher Sicht entscheidend sind: „Mastering API Architecture“ von O’Reilly, kostenlos zur Verfügung gestellt von NGINX.

Akzeptanzmetriken

Für ein API-First-Unternehmen ist es unerlässlich, über technische Kennzahlen hinauszublicken und zu verstehen, wie Entwickler mit Ihren APIs interagieren. Außerdem müssen Sie die API-Entwicklererfahrung messen und überwachen, um sicherzustellen, dass Entwickler Ihre APIs einsetzen und daraus einen Mehrwert ziehen.

Einige Beispiele für Akzeptanzmetriken sind:

Eindeutige API-Nutzer – Diese Kennzahl wird häufig auf monatliche Nutzer bezogen und misst, wie viele Entwickler Ihre APIs einsetzen und nutzen. Idealerweise steigt sie im Laufe der Zeit, wenn immer mehr Entwickler Ihre API in ihre Anwendungen integrieren.
Wachstum der API-Nutzung – Diese Kennzahl misst ebenfalls die API-Akzeptanz und wird dafür häufig bevorzugt herangezogen. Idealerweise steigt der API-Datenverkehr von Monat zu Monat, während zugleich die Zahl der Anwendungen und Entwickler zunimmt, die diese APIs nutzen.
Zeit bis zum ersten API-Aufruf – Diese Kennzahl misst, wie lange ein Entwickler benötigt, um ein Konto zu erstellen, API-Anmeldedaten zu generieren und den ersten API-Aufruf auszuführen. Da es höchste Priorität hat, Entwicklern einen möglichst schnellen Einstieg zu ermöglichen, ist diese Kennzahl die wichtigste zur Bewertung der gesamten API-Entwicklererfahrung.

Hinweis: Wir empfehlen, dass mindestens einer Ihrer KPIs die API-Akzeptanz misst. So lässt sich das Gesamtwachstum Ihres API-Programms ermitteln. Sie könnten beispielsweise einen KPI festlegen, um die Anzahl der Entwickler zu erhöhen, die mithilfe Ihrer API eine dauerhafte Integration oder App erstellt haben.

Produktmetriken

API-Produktmetriken spielen eine wichtige Rolle, wenn es darum geht, den Wert einer API zu verstehen. Auch wenn nur ein kleiner Teil der APIs direkt zum Umsatz beiträgt, muss jede API einen Mehrwert für das Unternehmen schaffen.

Zu den wichtigsten zu messenden Produktkennzahlen gehören:

Direkte und indirekte Umsätze – Diese Kennzahlen erfassen die verschiedenen Arten, wie APIs zum Umsatz beitragen. Während einige APIs direkt monetarisiert werden, unterstützen andere Integrationen mit Geschäftspartnern oder sind von Kunden geschätzte Drittanbieterintegrationen. Ähnlich wie bei der Akzeptanzrate Ihrer APIs hilft die Erfassung indirekter Umsätze Entwicklern dabei, umsatzgenerierende Apps für Partner zu entwickeln.
Anwendungen pro API – APIs müssen wiederverwendbar sein. Diese Kennzahl misst, wie viele Anwendungen eine API integrieren, um zu ermitteln, welche APIs den größten Mehrwert bieten.
Anzahl der Partner – APIs ermöglichen häufig Geschäftsbeziehungen. Die Erfassung der Anzahl von API-Integrationen mit Partnern trägt dazu bei, die Akzeptanz zu steigern und anderen Geschäftsbereichen den Mehrwert aufzuzeigen.

Hinweis: Diese Produktmetriken stehen in engem Zusammenhang mit den geschäftlichen Auswirkungen. Je nach Ihren Geschäftszielen können Sie einige davon als KPIs verwenden. Wenn das Geschäftsziel Ihrer API-Strategie beispielsweise darin besteht, über Drittanbieter mehr Kunden zu erreichen, sollten Sie sowohl die Anzahl der Partner, die Ihre APIs nutzen, als auch den indirekten Umsatz erfassen, der durch diese Integrationen erzielt wird.

Eine ausführlichere Betrachtung des API-Produktlebenszyklus – einschließlich geschäftlicher und operativer KPIs – finden Sie in den Kapiteln 3–5 von „Mastering API Architecture“.

Fazit

Die Abstimmung von API-Metriken und geschäftlichen KPIs ist eine der wichtigsten Voraussetzungen, um datengestützte Entscheidungen zu treffen und sicherzustellen, dass Ihre API-Strategie den für Ihr Unternehmen erforderlichen Mehrwert liefert. Darüber hinaus können Infrastruktur- und Anwendungsteams durch einen besseren Einblick in Ihre APIs genau die operativen Kennzahlen messen, die für sie am wichtigsten sind.

NGINX bietet Ihnen Einblick in Dutzende wichtiger API-Metriken. Sie können Echtzeit- und historische Metriken anzeigen und diese ganz einfach in die von Ihnen bevorzugte Lösung für Application Performance Monitoring (APM) oder Datenanalyse exportieren.

Starten Sie noch heute mit einer 30-tägigen kostenlosen Testversion der NGINX Management Suite, die den Zugriff auf API Connectivity Manager, NGINX Plus als API-Gateway und NGINX App Protect zum Schutz Ihrer APIs umfasst.