Debugging – Übersicht

Diese Seite gilt für Apigee und Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Debug ist ein Tool zur Fehlerbehebung und zum Monitoring von API-Proxys, die auf Apigee ausgeführt werden. Mit dem Debug-Tool können Sie die Details jedes einzelnen Schritts über einen API-Proxyablauf prüfen. Mit Apigee können Sie Debugging-Daten erfassen, die den gesamten Anfrage/Antwort-Ablauf Ihrer API-Proxys zeigen. Dies umfasst alle Anfrage- und Antwortparameter sowie Transformationen, die während der Richtlinienausführung angewendet werden. Dies ist wichtig für das Debugging und die Fehlerbehebung bei der API-Proxy-Entwicklung und -Bereitstellung.

Datenerhebung und ‑übertragung debuggen

Apigee-Gateway-Knoten erfassen Daten aus Debugging-Sitzungen und speichern sie intern im Cache, bevor sie an die Steuerungsebene in der Cloud übertragen werden. Von dort aus wird sie an die Benutzeroberfläche der Debugging-Sitzung weitergegeben, damit die Operatoren sie analysieren können.

Wenn Sie Maskierung für das Debugging verwenden, führt Apigee die Maskierung auf den Gateway-Knoten durch, bevor die Debugging-Daten an die Steuerungsebene übertragen werden.

Debugging verwenden

Sie können Debugging-Sitzungen mit dem Debug-Tool über die UI oder API erstellen und verwalten, wie unter Debug verwenden beschrieben. Alternativ können Sie Debugging-Sitzungen herunterladen und sie offline ansehen und analysieren. Weitere Informationen finden Sie unter Offline-Debug verwenden.

Verwendung des Apigee-Supports von Debug

Only customers can trigger a debug session, but Apigee Support can access non-deleted past debug sessions during the course of a support case to help troubleshoot proxy-specific issues.

Note the following:

  • Apigee Support has read-only permission to Debug data.
  • Apigee Support may request that you run a debug to capture information about an issue, and that you provide the debug session ID or a link to the debug session so that Support may review the captured debug. Since saved debug sessions are valid for only 24 hours, we recommend that you download the debug session and attach it to the case opened with Support to enable offline viewing.

Für Apigee hybrid-Nutzer

Wenn Sie Apigee Hybrid verwenden, lesen Sie die folgenden Abschnitte.

Debugging-Architektur

Im Folgenden wird der Prozess der Erstellung einer neuen Debugging-Sitzung dargestellt:

Zum Vergrößern klicken Grafik: Ein grober Überblick über eine Anfrage zum Starten einer Debugging-Sitzung 1. Grafik: Sie initiieren eine Anfrage zum Starten einer Debugging-Sitzung. Verwenden Sie dazu die UI oder die API. 2. Grafik: Die Verwaltungsebene sendet mithilfe des Pub/Sub-Modells eine Anfrage zur Erstellung einer Debugging-Sitzung an die Laufzeitebene. 3. Grafik: Der Synchronizer, der die Benachrichtigungen zur Debugging-Sitzung abonniert, sendet die Anfrage zur Erstellung an die Message Processors. 4. Grafik: Die MPs erfassen Debugging-Daten und streamen diese an einen Pod zur Datenerhebung. 5. fluent-bit schreibt die Debugging-Daten sofort in das Dateisystem des Pods. 6. Grafik: UDCA fragt das Dateisystem des Pods nach neuen Datendateien ab. 7. Grafik: Wenn eine neue Datendatei gefunden wird, lädt UDCA sie in den UAP-Dienst hoch. 8. Grafik: Sie können dann über Apigee-Dienste wie die Apigee Hybrid UI oder die Apigee APIs auf die Daten zugreifen.

Debugging-Daten werden auf der Verwaltungsebene bis zu 24 Stunden lang aufbewahrt.

Anforderungen an Apigee Hybrid

Dieser Abschnitt enthält wichtige Informationen für Apigee Hybrid-Nutzer.

Unterstützung für den Datenstandort

Ältere Versionen von Apigee Hybrid unterstützen den Datenstandort nicht.

Weitere Anforderungen

  • Sie müssen das apigee-udca-Dienstkonto konfiguriert haben. Siehe Konfigurationsüberschreibungen festlegen.
  • Die Uhren auf allen Synchronizer-Knoten sollten synchron sein und in UTC-Zeit angegeben werden