Abrufen von API-Analysen in Azure API Management
GILT FÜR: Developer | Basic | Basic v2 | Standard | Standard v2 | Premium | Premium v2
Azure API Management bietet Analysen für Ihre APIs, damit Sie ihre Nutzung und Leistung analysieren können. Verwenden Sie Analysen für die allgemeine Überwachung und Problembehandlung Ihrer APIs. Weitere Überwachungsfunktionen, einschließlich Metriken und Ressourcenprotokollen in nahezu Echtzeit für die Diagnose und Überwachung, finden Sie im Tutorial: Überwachen veröffentlicher APIs.
Hinweis
Diese Funktion ist derzeit in Arbeitsbereichen nicht verfügbar.
Informationen zu API-Analysen
API Management stellt Analysen mithilfe eines Azure Monitor-basierten Dashboards bereit. Das Dashboard aggregiert Daten in einem Azure Log Analytics-Arbeitsbereich.
In den klassischen API Management-Dienstebenen umfasst Ihre API-Verwaltungsinstanz auch ältere integrierte Analysen im Azure-Portal, und Analysedaten können mithilfe der API-Management-REST-API aufgerufen werden. Sehr ähnliche Daten werden im Azure Monitor-basierten Dashboard und in integrierten Analysen gezeigt.
Wichtig
- Das Azure Monitor-basierte Dashboard ist die empfohlene Methode für den Zugriff auf Analysedaten.
- Integrierte (klassische) Analysen sind auf den v2-Ebenen nicht verfügbar.
Mit API Analytics analysieren Sie die Nutzung und Leistung der APIs in Ihrer API Management-Instanz über mehrere Dimensionen hinweg, einschließlich:
- Zeit
- Geografie
- APIs
- API-Vorgänge
- Produkte
- Abonnements
- Benutzer
- Requests
Hinweis
- API Analytics stellen Daten zu Anforderungen bereit, einschließlich fehlgeschlagener und nicht autorisierter Anforderungen.
- Geografiewerte basieren ungefähr auf der IP-Adresszuordnung.
- Es kann eine Verzögerung bei der Verfügbarkeit von Analysedaten geben.
Azure Monitor-basiertes Dashboard
Um das Azure Monitor-basierte Dashboard zu verwenden, benötigen Sie einen Log Analytics-Arbeitsbereich als Datenquelle für API Management-Gatewayprotokolle.
Wenn Sie einen konfigurieren müssen, sind hier im Folgenden kurz Schritte zum Senden von Gatewayprotokollen an einen Log Analytics-Arbeitsbereich aufgeführt. Weitere Informationen finden Sie im Tutorial: Überwachen veröffentlichter APIs. Dies ist eine einmalige Aufgabe.
- Navigieren Sie im Azure-Portal zu Ihrer API Management-Instanz.
- Im linken Menü, unter Überwachung die Option Diagnoseeinstellungen>+ Diagnoseeinstellung hinzufügen auswählen.
- Geben Sie einen beschreibenden Namen für die Diagnoseeinstellung ein.
- Wählen Sie in Protokollen Protokolle im Zusammenhang mit dem ApiManagement-Gateway aus.
- Wählen Sie in den Zieldetails An Log Analytics senden aus, und wählen Sie einen Log Analytics-Arbeitsbereich im selben oder einem anderen Abonnement aus. Wenn Sie einen Arbeitsbereich erstellen müssen, lesen Sie Erstellen eines Log Analytics-Arbeitsbereichs.
- Vergewissern Sie sich, dass Ressourcenspezifisch als Zieltabelle ausgewählt ist.
- Wählen Sie Speichern.
Wichtig
Es kann bis zu 2 Stunden dauern, bis ein neuer Log Analytics-Arbeitsbereich Daten empfängt. Ein vorhandener Arbeitsbereich sollte innerhalb von etwa 15 Minuten Daten empfangen.
Zugreifen auf das Dashboard
Nachdem ein Log Analytics-Arbeitsbereich konfiguriert wurde, greifen Sie auf das Azure Monitor-basierte Dashboard zu, um die Nutzung und Leistung Ihrer APIs zu analysieren.
- Navigieren Sie im Azure-Portal zu Ihrer API Management-Instanz.
- Wählen Sie im Menü auf der linken Seite unter Überwachung die Option Analysen aus. Das Analysedashboard wird geöffnet.
- Wählen Sie einen Zeitraum für Daten aus.
- Wählen Sie eine Berichtskategorie für Analysedaten aus, z. B. Zeitachse, Geografie usw.
Ältere integrierte Analysen
In bestimmten API Management-Dienstebenen sind auch integrierte Analysen (auch als Legacyanalysen oder klassische Analysen bezeichnet) im Azure-Portal verfügbar, und Analysedaten können mithilfe der REST-API für API-Management aufgerufen werden.
Integrierte Analysen – Portal
So greifen Sie auf die integrierte (klassische) Analyse im Azure-Portal zu
- Navigieren Sie im Azure-Portal zu Ihrer API Management-Instanz.
- Wählen Sie im Menü auf der linken Seite unter Überwachung die Option Analysen (klassisch) aus.
- Wählen Sie einen Zeitbereich für die Daten aus, oder geben Sie einen benutzerdefinierten Zeitbereich ein.
- Wählen Sie eine Berichtskategorie für Analysedaten aus, z. B. Zeitachse, Geografie usw.
- Filtern Sie den Bericht optional nach mindestens einer zusätzlichen Kategorie.
Analysen – REST-API
Verwenden Sie Berichtevorgänge in der API Management REST-API, um Analysedaten für Ihre API Management-Instanz abzurufen und zu filtern.
Verfügbare Vorgänge geben Berichtsdatensätze nach API, Geografie, API-Vorgängen, Produkt, Anforderung, Abonnement, Uhrzeit oder Benutzer zurück.
Zugehöriger Inhalt
- Eine Einführung in Azure Monitor-Funktionen in API Management finden Sie im Tutorial: Überwachen von veröffentlichten APIs.
- Detaillierte Informationen zur HTTP-Protokollierung und -Überwachung finden Sie unter Überwachen Ihrer APIs mit Azure API Management, Event Hubs und Moesif.
- Informationen zum Integrieren von Azure API Management in Azure Application Insights.
- Weitere Informationen finden Sie unter Einstellung des integrierten API-Analysedashboards (März 2027).