<ph type="x-smartling-placeholder"></ph>
Sie sehen die Dokumentation zu Apigee Edge.
Gehen Sie zur
Apigee X-Dokumentation. Weitere Informationen
In diesem Thema wird Edge API Analytics vorgestellt.
Video: Sehen Sie sich ein kurzes Video an, um einen Überblick über die Edge API Analytics-Dienste zu erhalten.
API durch Analysen verbessern
Edge API Analytics erfasst und berechnet eine Fülle von Informationen, die über API-Proxys fließen. Sie können diese Daten mit Grafiken und Diagrammen in der Edge-Benutzeroberfläche visualisieren oder die Rohdaten für Offline-Analyse mithilfe der Edge-Management-APIs.
Mit Analytics erhalten Sie Antworten auf häufig gestellte Fragen wie:
- Wie entwickelt sich der API-Traffic im Laufe der Zeit?
- Welche API-Methoden sind am beliebtesten?
- Wer sind meine Top-Entwickler?
- Wann werden API-Antworten am schnellsten zurückgegeben? Wann am langsamsten?
- Aus welcher geografischen Region kommt der meiste API-Traffic?
Antworten auf Fragen wie diese helfen dabei, APIs zu verbessern, Probleme zu beheben und fundiertere Geschäftsentscheidungen in Bezug auf Ihr API-Programm zu treffen.
API Analytics ermöglicht Optimierungen
Durch einen kontinuierlichen Prozess des Sammelns, Analysierens und Visualisierens von Daten hilft Edge API Analytics Ihr API-Team bei der Verbesserung ihrer APIs und unterstützt App-Entwickler bei der Verbesserung ihrer Apps:
- API-Team – Das API-Team nutzt interne Systeme, um interessante APIs zu erstellen. Das API-Team möchte wissen, wie das API-Programm insgesamt läuft, wie einzelne APIs funktionieren und wie sie ihre APIs verbessern können.
- App-Entwickler: Wenn Sie Analysedaten mit App-Entwicklern teilen, erhalten Sie bessere Anwendungen. Diese Entwickler modernisieren Ihre API und erstellen kreative Anwendungen, mit denen Sie Ihren Umsatz steigern können. Mithilfe von Analytics wissen App-Entwickler, wie sich Anwendungen entwickeln und wie viel sie zum Endergebnis Ihres Unternehmens beitragen. App-Entwickler möchten wissen, wie sie ihre Anwendungen verbessern können.
- Ops-Team – Das Betriebsteam möchte Traffic-Muster verstehen und vorhersehen, wann Backend-Ressourcen hinzugefügt oder andere wichtige Anpassungen vorgenommen werden müssen.
- Geschäftsinhaber – Der Geschäftsinhaber möchte sehen, wie sich seine API-Investition bezahlt macht und wo er in Sachen APIs in die Zukunft investieren soll.
Welche Daten werden erfasst und analysiert?
Edge API Analytics erfasst und analysiert ein breites Spektrum von Daten, die über API-Proxys fließen, wie zum Beispiel:
- Antwortzeit
- Anfragelatenz
- Größe der Anfrage
- Zielfehler
- API-Produktname
- E-Mail-Adresse des Entwicklers
- App-Name
- Viele andere
Eine vollständige Liste der durch API Analytics erfassten Daten finden Sie in der Referenz zu Analysemesswerten, -dimensionen und -filtern.
Wie erfasse ich benutzerdefinierte Analysedaten?
Edge erfasst nativ eine Fülle von Daten. Möglicherweise möchten Sie auch benutzerdefinierte Analysedaten für Ihre API-Proxys, Anwendungen, Produkte oder Entwickler erheben. Sie können beispielsweise Analysedaten aus Abfrageparametern, Anfrageheadern, Anfrage- und Antworttexten oder Variablen erheben, die Sie in Ihren APIs definieren.
Sie erfassen benutzerdefinierte Analysedaten mithilfe der StatisticsCollector-Richtlinie. Nachdem die benutzerdefinierten Daten extrahiert wurden, können Sie die Daten mithilfe der Analyse-Benutzeroberfläche oder -API untersuchen. Ein vollständiges Beispiel zum Erfassen benutzerdefinierter Analysedaten findet sich unter Analysieren des API-Nachrichteninhalts mit benutzerdefinierten Analysen.
Unterschiede zwischen Analytics-Daten und API-Überwachungsdaten
In diesem Abschnitt werden einige kleinere Unterschiede zwischen den Daten beschrieben, die von Edge Analytics im Vergleich zur API-Überwachung. Da API-Monitoring und Analytics unterschiedliche Datenpipelines verwenden, sehen Sie möglicherweise kleine Unterschiede zwischen benutzerdefinierten Berichten, die von Monitoring generiert wurden, und Berichten, die von Analytics. Beispielsweise sehen Sie Abweichungen in den gemeldeten Ergebnissen für Zeitüberschreitungsfehler (beide Back-End-Zeitüberschreitungen) (HTTP-Statuscode 504 in der Anfrage) und Client-Zeitüberschreitungen (HTTP-Statuscode 499). Diese können in benutzerdefinierten Analytics-Berichten mit dem Statuscode 200, wird jedoch in benutzerdefinierten Monitoring-Berichten mit dem Statuscode 504 oder 499 angezeigt.Wann und wie lange sind meine Analysedaten verfügbar?
Es gibt zwei Zeitintervalle, die steuern, wann und wie lange Ihre Analysedaten angezeigt werden können:
- Datenverzögerungsintervall - Nach dem Aufruf eines API-Proxys kann es bis zu 10 Minuten, bis die Daten zur Anzeige oder über Verwaltungs-API-Aufrufe zugänglich sind.
- Datenaufbewahrung – Der Zeitraum, in dem Analysedaten von Edge abhängig vom Tarif aufbewahrt werden. Je nach Plan sind die Analysedaten für die letzten 30, 60, 90 oder 365 Tage verfügbar.
Wie greife ich auf meine Analysedaten zu?
Edge API Analytics bietet Datenvisualisierungstools, die in die Edge-Benutzeroberfläche integriert sind. Diese Tools umfassen vordefinierte Analyse-Dashboards und benutzerdefinierte Berichte, in denen Daten in Grafiken und Diagrammen angezeigt werden. Außerdem können Sie Daten nach verschiedenen Dimensionen aufschlüsseln (darunter API-Proxy, IP-Adresse oder HTTP-Statuscode).
Darüber hinaus können Sie Analysedaten mithilfe der Edge-Verwaltungs-API herunterladen. Nach dem Herunterladen können Sie diese Daten in Ihre eigenen Datenvisualisierungstools oder Ihr Analysesystem importieren.
Analytics-Dashboards
Die Edge-Benutzeroberfläche bietet eine Reihe vordefinierter Dashboards, mit denen Sie Analysedaten anzeigen können. Die folgenden Abbildungen zeigen beispielsweise das Dashboard für die Proxy-Leistung:
Dieses Dashboard enthält Diagramme für:
- Gesamter Traffic - Die Gesamtzahl der API-Anfragen, die von Edge für eine API-Umgebung in einer Organisation empfangen wurden.
- Erfolgreicher Traffic: Die Gesamtzahl der Anfragen, die zu einer erfolgreichen Antwort geführt haben. Fehlerantworten zählen nicht.
- Traffic-Fehler – Die Gesamtzahl aller nicht erfolgreichen API-Anfragen. Das heißt, Anfragen, die keine Antwort bedingt haben. Die Anzahl umfasst sowohl Proxy-Fehler (von Apigee) als auch Zielfehler (von den Backend-Diensten).
- Durchschnittliche TPS – Die durchschnittliche Anzahl von API-Anfragen und die daraus resultierenden Antworten pro Sekunde.
Weitere vordefinierte Dashboards sind:
- Cacheleistung
- Entwicklerengagement
- Gerätenutzung
- Fehlercodeanalyse
- GeoMap
- Latenzanalyse
- Leistung der Zielsysteme
- Traffic-Zusammensetzung
Weitere Informationen zu den vordefinierten Dashboards finden sich unter Verwenden der Analyse-Dashboards.
Benutzerdefinierte Berichte
Mit benutzerdefinierten Berichten können Sie bestimmte API-Messwerte aufschlüsseln und genau die Daten anzeigen, die Sie interessieren. Sie können einen benutzerdefinierten Bericht erstellen, indem Sie beliebige in Edge integrierte Analysedaten oder benutzerdefinierte Analysen verwenden. Daten, die von der StatisticsCollector-Richtlinie erfasst werden.
Beim Erstellen eines benutzerdefinierten Berichts wählen Sie die Daten aus, die Sie interessieren (Messwerte), gruppieren die Daten auf sinnvolle Weise (Dimensionen) und filtern optional die zurückgegebenen Daten anhand bestimmter Merkmale der Daten (Filter).
Sie können den im benutzerdefinierten Bericht angezeigten Diagrammtyp auch als Spalten- oder Liniendiagramm festlegen. Folgende Bilder zeigen Diagrammbeispiele für Transaktionen pro Sekunde, gruppiert nach API-Proxy:
Spalte: Jeder API-Proxy wird durch eine andere Spalte dargestellt:
Zeile: Jeder API-Proxy wird durch eine andere Zeile dargestellt:
Weitere Informationen finden Sie unter Benutzerdefinierte Berichte erstellen und verwalten.
Analytics API
Verwenden Sie die Edge-Verwaltungs-API, um Analysedaten herunterzuladen. Beispielsweise können Sie die API verwenden, um Ihre eigenen Visualisierungstools zu erstellen, die Sie in Portale oder benutzerdefinierte Anwendungen einbetten können.
Hier sehen Sie ein Beispiel für einen API-Aufruf zum Abruf von Analysedaten von API-Proxys:
curl https://api.enterprise.apigee.com/v1/o/org_name/environments/test/stats/apiproxy?"select=sum(message_count)&timeRange=6/24/2018%2000:00~6/24/2018%2023:59&timeUnit=hour" \ -u email:password
Der Aufruf gibt Folgendes zurück:
- Die Summe der Anfragen (Anzahl der Nachrichten) pro API-Proxy
- Über einen Zeitraum von 24 Stunden
- Nach Stunde gruppiert
Der Abfrageparameter timeRange
gibt den Zeitraum in folgender Form an:
?timeRange=MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM
Beachten Sie die Angabe %20
vor HH:MM
. Der Parameter timeRange
erfordert ein URL-codiertes Leerzeichen vor HH:MM
oder ein +
-Zeichen wie in MM/DD/YYYY+HH:MM~MM/DD/YYYY+HH:MM
.
Weitere Informationen finden Sie unter . Verwenden Sie die Metrik-APIs, um die Leistung des API-Programms zu messen.
Analysedaten in Google Cloud exportieren
Sie können die Edge-Verwaltungs-API verwenden, um alle Analysedaten für einen ganzen Tag aus Edge zu exportieren. in einem eigenen Daten-Repository wie Google Cloud Storage oder BigQuery speichern. Anschließend können Sie die leistungsstarke Funktionen für Abfragen und maschinelles Lernen von Google Cloud BigQuery und TensorFlow nutzen, um Ihre eigene Datenanalyse durchzuführen.
Weitere Informationen finden Sie unter Daten aus Analysen exportieren.
Wie gebe ich Daten für Anwendungsentwickler frei?
Wenn Sie sich App-Entwickler als Kunden vorstellen, sollten Sie dafür sorgen, dass ihnen die Tools und Informationen zur Verfügung stehen, mit denen sie Ihre API optimal nutzen können.
App-Entwickler interessieren sich nicht nur für die Qualität ihrer Anwendungen, sondern auch für Ihre APIs. Die Drupal-basierten Entwicklerportale enthalten eine optionale Seite zur Anwendungsleistung, auf der App-Entwickler auf wichtige Messwerte für ihre Anwendungen zugreifen können. Auf dieser Seite finden Entwickler Informationen zu folgenden Themen:
- Fehler: Welche API-Fehler treten bei meiner App auf?
- Leistung: Ist die API im Moment langsam? Welche API-Methoden sind grundsätzlich langsam oder nur derzeit langsam?
- Verfügbarkeit: Ist die API im Moment aktiv oder inaktiv?
- Kontingent: Hat die API ein Kontingent? Und wie stehe ich als App-Entwickler in Sachen Kontingent da?
Weitere Informationen:
- Drupal 7: Analyse der App-Nutzung
- Drupal 8: Apps überwachen
- Integriertes Portal: nicht verfügbar
Darüber hinaus können Sie Analysen auf folgende Arten für Ihre Entwickler freigeben:
- Benutzerdefinierte Berichte erstellen und mit App-Entwicklern teilen. Weitere Informationen siehe Benutzerdefinierte Berichte erstellen.
- Verwenden der Edge-Management-API zum Erfassen von Daten über einen längeren Zeitraum, um sie mit der App zu teilen und Entwickler offline. Weitere Informationen finden Sie unter <ph type="x-smartling-placeholder"></ph> Verwenden Sie die Metrik-APIs, um die API-Programmleistung zu messen.
Wie erstelle ich umfassende Analysedaten?
Was verstehen wir unter einer umfassenden Analyse? Wenn Sie beispielsweise einen API-Proxy erstellen, wird Edge um Analysedaten über diesen Proxy zu sammeln. Aber wie sieht es mit Messwerten zum Entwickler oder zur App aus, die das API-Proxy aufgerufen hat? Wenn Edge nicht weiß, wer einen API-Aufruf getätigt hat, kann es diese Daten nicht erfassen.
Es sind nur ein paar Schritte erforderlich, damit Edge herausfinden kann, welche Entwickler und welche Entwickler-Apps es sind. Ihre API-Proxys aufrufen. Hier eine Liste dieser Schritte mit Links zu detaillierteren Informationen:
- Erstellen eines oder mehrerer API-Produkte, d. h. eine Gruppe von API-Proxys mit einem Serviceplan. Siehe API-Produkte verwalten.
- Registrieren Sie App-Entwickler bei Edge. Weitere Informationen finden Sie unter . App-Entwickler registrieren
- Registrieren Sie Apps und generieren Sie API-Schlüssel für Ihre Entwickler. Weitere Informationen finden Sie unter . Apps registrieren und API-Schlüssel verwalten
- Fügen Sie Sicherheitsrichtlinien zu Ihren API-Proxys hinzu, die API-Schlüssel und/oder Sicherheitstoken prüfen. Siehe folgende Themen:API-Schlüsselrichtlinie prüfen, OAuthV2-Richtlinie und JWT-Richtlinie prüfen.
- Wenn Sie Edge Microgateway verwenden, Das Analyse-Plug-in muss aktiviert sein. (standardmäßig aktiviert). Wenn das Analyse-Plug-in deaktiviert ist, sendet Edge Microgateway keine Analysedaten an die Edge-Analyse.
In folgenden Anleitungen werden Sie durch die erforderlichen Schritte geführt, mit denen Sie Analysen für Entwickler und Anwendungen aufrufen können: APIs durch erforderliche API-Schlüssel sichern und APIs mit OAuth sichern
Vergleich: API-Analysen und API Monitoring
Sie können sowohl das Edge-API-Monitoring und API Analytics. API-Monitoring untersucht Analysedaten, um in Echtzeit kontextbezogene Einblicke in Mit der API-Leistung können Sie schnell Probleme diagnostizieren und Abhilfemaßnahmen für die Aufrechterhaltung des Geschäftsbetriebs ergreifen. Das API-Monitoring wurde entwickelt, um Probleme in Ihren APIs und Back-Ends schnell zu finden. API Analytics wurde entwickelt, um eine breite Palette von Analysedaten zur Verwendung durch verschiedene Teams zu erfassen. aber die Daten werden in der Regel für Analysen in Nicht-Echtzeit-Szenarien verwendet.
Einer der Hauptunterschiede zwischen API-Überwachung und API-Analyse ist der Warnmechanismus, der in das API-Monitoring. Mit Alerts geben Sie einen HTTP-Statuscode (2xx/4xx/5xx), Latenz oder Fehlercode an Grenzwert, der bei Überschreitung eine Benachrichtigung an Ihr Ops-Team auslöst. Benachrichtigungen können über verschiedene Kanäle wie E-Mail, Slack, Pager oder Webhooks gesendet werden, auf Probleme stoßen.
Siehe Vergleichen der API-Überwachung mit Edge API Analytics finden Sie einen detaillierteren Vergleich zwischen diesen Diensten.