Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu
Apigee X. info
In diesem Abschnitt wird API Monitoring mit Edge Analytics verglichen. Obwohl Sie mit API Monitoring und Edge Analytics API-Daten erfassen und ansehen können, haben sie unterschiedliche Ziele:
- Das Ziel von API Monitoring ist es, sicherzustellen, dass Ihre APIs wie vorgesehen funktionieren. Dazu benötigen Sie die neuesten verfügbaren Daten. API Monitoring bietet Daten, die nahezu in Echtzeit verfügbar sind, und ermöglicht Ihnen, Benachrichtigungen zu erstellen, die Sie im Falle eines Problems informieren.
- Das Ziel von Edge Analytics ist es, das langfristige Verhalten Ihrer APIs zu verstehen, damit Sie sicherstellen können, dass sie Ihre Geschäftsanforderungen erfüllen, 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 um höchstens 10 Minuten.
API Monitoring-Daten, die sich hauptsächlich auf Fehlercodes und Latenz beziehen, sind eine kleine Teilmenge der Analytics-Daten.
Unterschiede zwischen API Monitoring- und Analytics-Daten
In diesem Abschnitt werden einige geringfügige Unterschiede zwischen den von Edge Analytics und API Monitoring erfassten Daten beschrieben. Da API Monitoring und Analytics unterschiedliche Datenpipelines verwenden, können geringfügige Unterschiede zwischen benutzerdefinierten Berichten auftreten, die von Monitoring und von 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). Diese können in benutzerdefinierten Analytics-Berichten mit dem Statuscode 200 angezeigt werden, 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 auf der Grundlage von kontextbezogenen Benachrichtigungen geeignete Maßnahmen, 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
Edge API Analytics erfasst und analysiert Informationen, die über APIs übertragen werden. API Analytics erfasst Informationen wie:
- Wie sich der API-Traffic im Laufe der Zeit entwickelt
- Welche sind Ihre wichtigsten Anwendungen
- Wer sind Ihre wichtigsten Entwickler
- Welche API-Methoden sind am beliebtesten
- Wann werden API-Antworten am schnellsten/langsamsten zurückgegeben
- Aus welcher geografischen Region kommt der meiste API-Traffic
Von API Analytics erfasste Daten
API Analytics erfasst und analysiert ein breites Spektrum an Daten, die über APIs übertragen werden. Während Ihre API bereitgestellt wird, erfasst Analytics beispielsweise ständig die Anzahl der empfangenen Nachrichten, die Anzahl der Entwickler, die Antwortzeiten, die Fehler, die Anzahl der verwendeten Anwendungen, die Anfragengröße und viele andere Daten.
Eine gute Einführung in Messwerte und deren Verwendung finden Sie unter Verwenden der Messwert-APIs zum Messen der API-Programmleistung. Eine vollständige Liste der Messwerte finden Sie unter Referenz zu Analysemesswerten, -dimensionen und -filtern.
Benutzerdefinierte Messwerte erfassen
Sie können auch benutzerdefinierte Messwerte mit der StatisticsCollector-Richtlinie erfassen. Mit der StatisticsCollector-Richtlinie können Informationen aus Anfrageheadern, XML-/JSON-Nutzlasten, Abfrageparametern, URIs und anderen Speicherorten an den Analytics-Server gesendet werden, um sie zu analysieren und Berichte zu erstellen.
Auf Analytics-Daten zugreifen
Nach der Generierung können Sie mit den API Analytics-Visualisierungstools auf vordefinierte und benutzerdefinierte Messwerte zugreifen, einschließlich Dashboard, benutzerdefinierte Berichte und GeoMap. Weitere Informationen zu den von API Analytics bereitgestellten Visualisierungstools finden Sie unter Analytics-Dashboards. Weitere Informationen zu benutzerdefinierten Berichten finden Sie unter Benutzerdefinierte Berichte erstellen.
API Monitoring und API Analytics vergleichen
API-Entwickler verwenden sowohl API Monitoring als auch API Analytics. Einer der Hauptunterschiede zwischen den beiden ist der in API Monitoring integrierte Benachrichtigungsmechanismus. Mit Benachrichtigungen kann Ihr Betriebsteam in Echtzeit auf Probleme mit Ihren APIs reagieren, um sicherzustellen, dass Ihre APIs verfügbar sind und wie erwartet funktionieren.
Benachrichtigungsbedingungen definieren bestimmte Statuscode-, Latenz- und Fehlercode-Schwellenwerte (2xx/4xx/5xx), 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 Umgebungsebene, API-Proxy- oder Zieldienstebene oder Regionsebene einrichten.
Nachdem eine Benachrichtigung ausgelöst wurde, kann Ihr Betriebsteam die API Monitoring-Benutzeroberfläche verwenden, um das Problem zu untersuchen und die Ursache zu ermitteln. Anschließend können Sie einen benutzerdefinierten Bericht erstellen, der vordefinierte Informationen zur Benachrichtigung enthält, z. B.:
- Gesamtantwortzeit
- Zielantwortzeit
- Proxy-Fehler
- Zielfehler
- Anfrage-UUID
- und viele weitere
API Analytics wurde entwickelt, um eine breite Palette von Daten zu erfassen, die von mehreren Teams verwendet werden können. Beispiel:
- Das Betriebsteam kann Analytics-Daten verwenden, um Zeiträume mit hohem oder niedrigem Traffic zu ermitteln, damit es Ihre Dienste entsprechend den sich ändernden Anforderungen hoch- oder herunterskalieren kann.
- Das Marketingteam kann Analytics-Daten verwenden, um Nutzungsmuster von Kunden zu ermitteln, die durch einzelne APIs, Anwendungen, Kunden oder andere Daten identifiziert werden.
- Alle Teams können auf benutzerdefinierte Daten zugreifen, die aus einer Anfrage erfasst wurden, um bestimmte Informationen wie Headerwerte, Abfrageparameter oder die Anfragenutzlast zu verfolgen.