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.

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

Nur Kunden können eine Fehlerbehebungssitzung auslösen. Der Apigee-Support kann während eines Supportfalls jedoch auf nicht gelöschte vergangene Fehlerbehebungssitzungen zugreifen, um Proxy-spezifische Probleme zu beheben.

Wichtige Hinweise:

  • Der Apigee-Support hat Lesezugriff auf Debug-Daten.
  • Der Apigee-Support kann Sie auffordern, einen Debug auszuführen, um Informationen zu einem Problem zu erfassen, und dass Sie die Debug-Sitzungs-ID oder einen Link zur Debug-Sitzung bereitstellen, damit der Support den erfassten Trace überprüfen kann. Da gespeicherte Debug-Sitzungen 24 Stunden lang gültig sind, sollten Sie die Debug-Sitzung herunterladen und mit dem Support-Fall verknüpfen, um dem Support die Offline-Anzeige zu ermöglichen.

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:

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. fluentd 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.

Vorbereitung

Wenn Sie Apigee Hybrid verwenden, müssen Sie Folgendes konfigurieren, bevor Sie das Debugging verwenden können:

Dienstkonten:

  • apigee-synchronizer (Rolle: Apigee Synchronizer Manager)
  • apigee-udca (Rolle: Apigee Analytics Agent)

Weitere Informationen zu Apigee Hybrid finden Sie unter Dienstkonten erstellen.

Synchronizer: