Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen
In diesem Abschnitt wird das API-Monitoring mit Edge Analytics verglichen. Obwohl Sie sowohl mit API-Monitoring als auch mit Edge Analytics API-Daten erfassen und anzeigen können, haben sie unterschiedliche Ziele:
- Mit API-Monitoring möchten wir dafür sorgen, dass Ihre APIs wie vorgesehen ausgeführt werden. Zu diesem Zweck möchten Sie die neuesten verfügbaren Daten sehen. API Monitoring stellt Daten nahezu in Echtzeit bereit und ermöglicht Ihnen das Erstellen von Benachrichtigungen, wenn ein Problem auftritt.
- Das Ziel von Edge Analytics besteht darin, 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 die Analytics-Daten leicht verzögert, in der Regel um maximal 10 Minuten.
API-Überwachungsdaten, die sich hauptsächlich auf Fehlercodes und Latenz beziehen, sind eine kleine Teilmenge von Analytics-Daten.
Unterschiede zwischen API-Überwachungsdaten und Analytics-Daten
In diesem Abschnitt werden einige geringfügige Unterschiede zwischen von Edge Analytics erfassten Daten und dem API-Monitoring beschrieben. Da API-Monitoring und Analytics unterschiedliche Datenpipelines verwenden, kann es zu geringfügigen Unterschieden zwischen den von Monitoring und Analytics generierten benutzerdefinierten Berichten kommen. Es können beispielsweise Abweichungen bei den gemeldeten Ergebnissen für Zeitüberschreitungsfehler auftreten – sowohl Back-End-Zeitüberschreitungen (HTTP-Statuscode 504 in der Anfrage) als auch Clientzeitüberschreitungen (HTTP-Statuscode 499). Diese können in benutzerdefinierten Analytics-Berichten mit dem Statuscode 200 angezeigt werden, in benutzerdefinierten Monitoringberichten jedoch mit dem Statuscode 504 oder 499.API-Monitoring
API-Monitoring bietet Echtzeitinformationen 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 Zeit bis zur Diagnose (MTTD).
- Anhand von kontextbezogenen Benachrichtigungen können Sie geeignete Maßnahmen ergreifen, bevor die Verbraucher betroffen sind.
- Nutzen Sie die Fehlercodes von Apigee, um die Diagnose zu beschleunigen.
- Isolieren Sie Problembereiche schnell, um Fehler-, Leistungs- und Latenzprobleme sowie deren Ursache zu diagnostizieren.
Edge-API-Analyse
Edge API Analytics erfasst und analysiert Informationen, die über APIs fließen. API Analytics erfasst Informationen wie:
- Wie sich Ihr API-Traffic im Laufe der Zeit entwickelt
- Was sind deine Top-Apps?
- Wer sind deine Top-Entwickler?
- Welche API-Methoden sind am beliebtesten
- Wann ist die Antwortzeit der API am schnellsten/langsamsten?
- Geografisch, wo Sie den meisten API-Traffic sehen
Von API Analytics erfasste Daten
Mit API Analytics wird ein breites Spektrum an Daten über APIs erfasst und analysiert. Während Ihre API bereitgestellt wird, zeichnet Analytics beispielsweise ständig die Anzahl der empfangenen Nachrichten, die Anzahl der Entwickler, die Antwortzeiten, Fehler, die Anzahl der verwendeten Apps, die Anfragegröße und viele andere Daten auf.
Eine gute Einführung in Messwerte und deren Verwendung finden Sie unter Verwenden der Metrik-APIs zum Messen der API-Programmleistung. Eine vollständige Liste der Messwerte finden Sie unter Referenz zu Analytics-Metriken, -Dimensionen und -Filtern.
Benutzerdefinierte Messwerte erfassen
Sie können auch benutzerdefinierte Metriken mithilfe der Richtlinie StatisticsCollector erfassen. Die StatisticsCollector-Richtlinie kann Informationen aus Anfrageheadern, XML-/JSON-Nutzlasten, Abfrageparametern, URIs und anderen Speicherorten zur Analyse und Berichterstellung in den Analytics Server schreiben.
Auf Analytics-Daten zugreifen
Nach der Generierung können Sie auf vordefinierte Metriken und benutzerdefinierte Metriken zugreifen, indem Sie die API Analytics-Visualisierungstools verwenden, 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 Erstellen von benutzerdefinierten Berichten.
Vergleich von API-Monitoring und API-Analyse
API-Entwickler verwenden sowohl API-Monitoring als auch API Analytics. Einer der Hauptunterschiede zwischen den beiden ist der in das API-Monitoring integrierte Warnmechanismus. Mithilfe von Benachrichtigungen kann Ihr Betriebsteam in Echtzeit auf Probleme mit Ihren APIs reagieren, um sicherzustellen, dass Ihre APIs verfügbar sind und wie erwartet funktionieren.
Alarmbedingungen definieren bestimmte Grenzwerte für Statuscode (2xx/4xx/5xx), Latenz und Fehlercodes, die bei Überschreitung visuelle Warnungen in der Benutzeroberfläche auslösen und Benachrichtigungen über eine Vielzahl von Kanälen wie E-Mail, Slack, PagerDuty oder Webhooks senden. Sie können Warnungen auf Umgebungs-, API-Proxy-, Zieldienst- oder Regionsebene einrichten.
Nachdem eine Benachrichtigung ausgelöst wurde, kann Ihr Betriebsteam die API-Überwachungsbenutzeroberfläche verwenden, um das Problem zu untersuchen und seine Ursache aufzuschlüsseln. Anschließend können Sie einen benutzerdefinierten Bericht erstellen, der vordefinierte Informationen zur Benachrichtigung enthält, z. B.:
- Gesamtantwortzeit
- Zielantwortzeit
- Proxy-Fehler
- Zielfehler
- UUID anfordern
- Und vieles mehr...
API Analytics wurde entwickelt, um eine breite Palette von Daten zur Verwendung durch mehrere Teams zu erfassen. Beispiel:
- Das Betriebsteam kann Analytics-Daten verwenden, um Zeiten mit hohem oder niedrigem Traffic zu identifizieren, damit es Ihre Dienste skalieren oder verkleinern kann, um sich ändernden Anforderungen gerecht zu werden.
- Das Marketingteam kann Analytics-Daten verwenden, um Kundennutzungsmuster zu ermitteln, die durch einzelne APIs, Apps, Kunden oder andere Daten identifiziert werden.
- Alle Teams können auf benutzerdefinierte Daten zugreifen, die aus einer Anfrage erhoben wurden, um bestimmte Informationen wie Headerwerte, Abfrageparameter oder Anforderungsnutzlast zu verfolgen.