Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an. info
In diesem Abschnitt wird das API-Monitoring mit Edge Analytics verglichen. Mit API-Monitoring und Edge Analytics können Sie zwar API-Daten erfassen und ansehen, sie haben aber unterschiedliche Ziele:
- Das Ziel des API-Monitorings besteht darin, dafür zu sorgen, dass Ihre APIs wie vorgesehen funktionieren. Dazu sollten Sie die neuesten verfügbaren Daten sehen. API-Monitoring bietet Daten, die nahezu in Echtzeit verfügbar sind. Außerdem können Sie Benachrichtigungen erstellen, die Sie bei Problemen informieren.
- Edge Analytics soll Ihnen dabei helfen, das langfristige Verhalten Ihrer APIs zu verstehen, damit Sie sicherstellen können, dass sie Ihre Geschäftsanforderungen unterstützen, oder bei Bedarf Änderungen vornehmen. Für diese Zwecke ist es weniger wichtig, Echtzeitdaten zu sehen. Daher sind Analytics-Daten etwas verzögert, in der Regel jedoch höchstens 10 Minuten.
API-Monitoring-Daten, die hauptsächlich mit Fehlercodes und Latenz zusammenhängen, sind nur ein kleiner Teil der Analytics-Daten.
Unterschiede zwischen API-Monitoring-Daten und Analytics-Daten
In diesem Abschnitt werden einige geringfügige Unterschiede zwischen den Daten beschrieben, die mit Edge Analytics und API Monitoring erfasst werden. Da API-Monitoring und Analytics unterschiedliche Datenpipelines verwenden, kann es zu geringfügigen Abweichungen zwischen benutzerdefinierten Berichten kommen, die von Monitoring und Analytics generiert werden. Beispielsweise können Abweichungen bei den gemeldeten Ergebnissen für Zeitüberschreitungsfehler auftreten, sowohl bei Backend-Zeitüberschreitungen (HTTP-Statuscode 504 in der Anfrage) als auch bei Client-Zeitüberschreitungen (HTTP-Statuscode 499). In benutzerdefinierten Analytics-Berichten werden sie möglicherweise mit dem Statuscode 200 angezeigt, in benutzerdefinierten Monitoring-Berichten jedoch mit dem Statuscode 504 oder 499.API-Monitoring
API-Monitoring bietet Echtzeitstatistiken zur API-Leistung und hilft Ihnen, Probleme schnell zu diagnostizieren und zu beheben, damit Ihre APIs wie vorgesehen funktionieren.
Vorteile des API-Monitoring:
- Erhöhen Sie die API-Verfügbarkeit und reduzieren Sie die mittlere Diagnosezeit (Mean Time To Diagnosis, MTTD).
- Treffen Sie geeignete Maßnahmen auf Basis von kontextbezogenen Benachrichtigungen, bevor Nutzer betroffen sind.
- Verwenden Sie Apigee-Fehlercodes, um die Diagnose zu beschleunigen.
- Isolieren Sie Problembereiche schnell, um Fehler-, Leistungs- und Latenzprobleme sowie deren Quelle zu diagnostizieren.
Edge API Analytics
Mit Edge API Analytics werden Informationen erfasst und analysiert, die über APIs fließen. API Analytics erfasst unter anderem folgende Informationen:
- Entwicklung des API-Traffics im Zeitverlauf
- Welche sind Ihre Top-Apps?
- Wer sind Ihre wichtigsten Entwickler?
- Welche API-Methoden sind am beliebtesten?
- Wann ist die API-Antwortzeit am schnellsten/langsamsten?
- Aus welcher geografischen Region kommt der meiste API-Traffic?
Von API Analytics erhobene Daten
Mit API Analytics werden Daten aus APIs erfasst und analysiert. Wenn Ihre API beispielsweise bereitgestellt wird, werden in Analytics kontinuierlich die Anzahl der empfangenen Nachrichten, die Anzahl der Entwickler, die Antwortzeiten, Fehler, die Anzahl der verwendeten Apps, die Anfragegröße und viele weitere Daten erfasst.
Eine gute Einführung in Messwerte und ihre Verwendung finden Sie unter Mess-APIs zum Messen der API-Programmleistung verwenden. Eine vollständige Liste der Messwerte finden Sie in der Referenz zu Analysemesswerten, -dimensionen und -filtern.
Benutzerdefinierte Messwerte erfassen
Mit der StatisticsCollector-Richtlinie können Sie auch benutzerdefinierte Messwerte erfassen. Mit der Richtlinie „StatisticsCollector“ können Informationen aus Anfrageheadern, XML-/JSON-Nutzlasten, Abfrageparametern, URIs und anderen Speicherorten auf den Analytics-Server geschrieben werden, um sie zu analysieren und Berichte zu generieren.
Auf Analytics-Daten zugreifen
Nach der Generierung können Sie über die Visualisierungstools der API Analytics auf vordefinierte und benutzerdefinierte Messwerte zugreifen, z. B. auf das Dashboard, benutzerdefinierte Berichte und die GeoMap. Weitere Informationen zu den Visualisierungstools von API Analytics finden Sie unter Analytics-Dashboards. Weitere Informationen zu benutzerdefinierten Berichten finden Sie unter Benutzerdefinierte Berichte erstellen.
API-Monitoring und API-Analysen vergleichen
API-Entwickler verwenden sowohl API Monitoring als auch API Analytics. Einer der Hauptunterschiede zwischen den beiden ist der in API Monitoring integrierte Benachrichtigungsmechanismus. Mithilfe von Benachrichtigungen kann Ihr Betriebsteam in Echtzeit auf Probleme mit Ihren APIs reagieren, damit diese verfügbar sind und wie erwartet funktionieren.
Mit Benachrichtigungsbedingungen werden bestimmte Statuscodes (2xx/4xx/5xx), Latenz und Fehlercodegrenzwerte definiert, die bei Überschreitung visuelle Benachrichtigungen in der Benutzeroberfläche auslösen und Benachrichtigungen über verschiedene Kanäle wie E-Mail, Slack, PagerDuty oder Webhooks senden. Sie können Benachrichtigungen auf Umgebungs-, API-Proxy-, Zieldienst- oder Regionsebene einrichten.
Nachdem eine Benachrichtigung ausgelöst wurde, kann Ihr Einsatzteam das Problem über die API-Monitoring-Benutzeroberfläche untersuchen und die Ursache ermitteln. Sie können dann einen benutzerdefinierten Bericht erstellen, der vordefinierte Informationen zur Benachrichtigung enthält, z. B.:
- Gesamtantwortzeit
- Zielantwortzeit
- Proxy-Fehler
- Zielfehler
- UUID der Anfrage
- und viele weitere
API Analytics sind so konzipiert, dass eine Vielzahl von Daten erfasst werden, die von mehreren Teams verwendet werden können. Beispiel:
- Das Operationsteam kann Analytics-Daten verwenden, um Zeiten mit hohem oder niedrigem Traffic zu identifizieren, damit die Dienste entsprechend den sich ändernden Anforderungen skaliert werden können.
- Das Marketingteam kann Analytics-Daten verwenden, um Nutzungsmuster von Kunden zu ermitteln, die von einzelnen APIs, Apps, Kunden oder anderen Daten stammen.
- Alle Teams können auf benutzerdefinierte Daten zugreifen, die aus einer Anfrage erfasst wurden, um bestimmte Informationen wie Headerwerte, Abfrageparameter oder Anfragenutzlast zu erfassen.