Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation info
Was ist das Trace-Tool?
Trace ist ein Tool zur Fehlerbehebung und zum Monitoring von API-Proxys, die auf Apigee Edge ausgeführt werden. Mit Trace können Sie die Details jedes Schritts eines API-Proxy-Ablaufs prüfen.
In diesem Video erhalten Sie eine Einführung in das Trace-Tool.
Trace verwenden
Trace ist einfach zu verwenden. Sie starten eine Trace-Sitzung, rufen die Edge-Plattform über die API auf und lesen die Ergebnisse.
- Greifen Sie wie unten beschrieben auf die Seite "API-Proxies" zu.
Edge
So rufen Sie die Seite „API-Proxys“ über die Edge-Benutzeroberfläche auf:
- Melden Sie sich unter apigee.com/edge an.
- Wählen Sie in der linken Navigationsleiste Develop > API Proxies aus.
Neue Edge-Benutzeroberfläche (Private Cloud)
So rufen Sie die Seite „API-Proxys“ über die New Edge-Benutzeroberfläche auf:
- Melden Sie sich unter
http://host:3001/edgein der neuen Edge-Benutzeroberfläche an. Dabei ist host die IP-Adresse oder der DNS-Name des Hosts, auf dem die neue Edge-Benutzeroberfläche ausgeführt wird. - Wählen Sie in der linken Navigationsleiste Develop > API Proxies aus.
- Wählen Sie auf der Seite „API-Proxys“ einen API-Proxy aus.
- Achten Sie darauf, dass die API, die Sie tracen möchten, bereitgestellt ist.
- Klicken Sie auf Trace, um die Ansicht des Trace-Tools aufzurufen.
- Wählen Sie im Drop-down-Menü Bereitstellung für Trace die Bereitstellungsumgebung und die Proxy-Überarbeitung aus, die Sie verfolgen möchten.
- Klicken Sie auf Trace-Sitzung starten. Wenn die Trace-Sitzung aktiv ist, zeichnet der API-Proxy Details zu jedem Schritt in der Verarbeitungspipeline auf. Während die Trace-Sitzung ausgeführt wird, werden Nachrichten und Kontextdaten aus dem Live-Traffic erfasst.

- Wenn kein Live-Traffic über Ihren Proxy fließt, senden Sie einfach eine Anfrage an die API. Sie können ein beliebiges Tool zum Senden der Anfrage verwenden, z. B. curl, Postman oder ein anderes vertrautes Tool. Sie können die Anfrage auch direkt über das Trace-Tool senden. Geben Sie einfach die URL ein und klicken Sie auf Senden. Hinweis: Sie können über das Trace-Tool nur eine GET-Anfrage senden, keine POST-Anfrage.
Hinweis: Eine Trace-Sitzung kann 10 Anfrage-/Antworttransaktionen pro Message Processor über den ausgewählten API-Proxy unterstützen. In Edge Cloud werden mit zwei Message Processors, die Traffic verarbeiten, 20 Anfrage-/Antworttransaktionen unterstützt. Eine Trace-Sitzung wird nach 10 Minuten automatisch beendet, wenn Sie sie nicht manuell beenden.
- Wenn Sie eine ausreichende Anzahl von Anfragen erfasst haben, klicken Sie auf Trace-Sitzung beenden.
- Im Menü auf der linken Seite wird eine Liste der erfassten Anfrage-/Antworttransaktionen angezeigt. Klicken Sie auf eine der Transaktionen, um detaillierte Ergebnisse aufzurufen.
Traces richtig lesen
Das Trace-Tool besteht aus zwei Hauptteilen: der Transaktionskarte und den Phasendetails:
- Die Transaktionskarte verwendet Symbole, um jeden wichtigen Schritt zu markieren, der während einer API-Proxy-Transaktion auftritt, einschließlich Richtlinienausführung, bedingte Schritte und Übergänge. Bewegen Sie den Mauszeiger auf ein beliebiges Symbol, um eine Zusammenfassung der Informationen zu sehen. Die Schritte des Anfrageflusses werden im oberen Bereich der Transaktionszuordnung und der Schritte des Antwortflusses unten angezeigt.
- Der Abschnitt Phasendetails des Tools enthält Informationen zur internen Verarbeitung des Proxys, einschließlich Variablen, die festgelegt oder gelesen wurden, Anfrage- und Antwortheader und vieles mehr. Klicken Sie auf ein beliebiges Symbol, um die Phasendetails für diesen Schritt aufzurufen.
Hier ist ein Beispiel einer Trace-Tool-Zuordnung mit Labels der wichtigsten Proxy-Verarbeitungssegmenten:
Transaktionskarte des Trace-Tools

Legende für die Transaktionskarte
In der folgenden Tabelle wird der Intent der Symbole beschrieben, die in der Transaktionszuordnung angezeigt werden. Diese Symbole markieren jeden der wichtigsten Verarbeitungsschritte während des Proxyablauf.
Symbol für Transaktionskarte
![]() |
Die Clientanwendung, die eine Anfrage an den ProxyEndpoint des API-Proxys sendet. |
| Die Kreise kennzeichnen Übergangsendpunkte im Proxy-Ablauf. Sie werden angezeigt, wenn eine Anfrage vom Client eingeht, wenn die Anfrage beim Ziel eingeht, wenn die Antwort vom Ziel eingeht und wenn die Antwort an den Client zurückgegeben wird. | |
|
Die hohen Balken kennzeichnen den Beginn eines Ablaufsegments im API-Proxy-Ablauf. Ablaufsegmente: ProxyEndpoint-Anfrage, TargetEndpoint-Anfrage, TargetEndpoint-Antwort und ProxyEndpoint-Antwort. Ein Segment enthält den PreFlow, ConditionalFlows und PostFlow. Weitere Informationen finden Sie unter Abläufe konfigurieren. |
|
|
Gibt an, dass Analytics-Aktionen im Hintergrund ausgeführt wurden. |
|
|
Ein bedingter Ablauf, der mit „true“ ausgewertet wird. Eine Einführung in bedingte Abläufe finden Sie unter Abläufe konfigurieren. Beachten Sie, dass einige Bedingungen von Edge generiert werden. Im Folgenden finden Sie beispielsweise einen Ausdruck, mit dem Edge prüft, ob im ProxyEndpoint ein Fehler aufgetreten ist: ((error.state equals PROXY_REQ_FLOW) or (error.state equals
PROXY_RESP_FLOW))
|
|
|
Ein bedingter Ablauf, der mit „false“ ausgewertet wird Eine Einführung zu bedingten Abläufen finden Sie unter Abläufe konfigurieren. Beachten Sie, dass einige Bedingungen von Edge generiert werden. Im Folgenden finden Sie beispielsweise einen Ausdruck, mit dem Edge prüft, ob im TargetEndpoint ein Fehler aufgetreten ist: (((error.state equals TARGET_REQ_FLOW) or (error.state equals
TARGET_RESP_FLOW)) or ((error.state equals REQ_SENT) or (error.state equals
RESP_START)))
|
|
|
|
Richtlinien Jeder Richtlinientyp hat ein eindeutiges Symbol. Dieses ist für die Richtlinie „AssignMessage“. Mit diesen Symbolen können Sie nachvollziehen, wo Richtlinien in der richtigen Reihenfolge ausgeführt werden und ob sie erfolgreich sind. Sie können auf ein Richtliniensymbol klicken, um die Ergebnisse der Ausführung aufzurufen und zu sehen, ob sie erwartet werden oder nicht. Sie können beispielsweise sehen, ob die Nachricht richtig umgewandelt wurde oder ob sie im Cache gespeichert wird. Richtlinien, die ordnungsgemäß ausgeführt werden, sind mit einem Häkchen gekennzeichnet. Im Falle eines Fehlers wird auf dem Symbol ein rotes Ausrufezeichen angezeigt. Tipp: Achten Sie auf die Kurzinfo oder die Zeitachse, um zu sehen, ob eine Richtlinie länger als erwartet dauert. |
![]() |
Wird angezeigt, wenn das Back-End-Ziel eine Node.js-Anwendung ist. Weitere Informationen finden Sie unter Übersicht über Node.js in Apigee Edge. |
![]() |
Das vom API-Proxy aufgerufene Backend-Ziel. |
![]() |
Die Zeitangabe gibt an, wie lange die Verarbeitungszeit in Millisekunden dauert. Durch den Vergleich der verstrichenen Zeitsegmente können Sie die Richtlinien ermitteln, deren Ausführung am längsten dauert und die API-Aufrufe verlangsamen. |
| Das Epsilon ist ein Zeitraum, der kleiner als eine Millisekunde ist. | |
|
Deaktiviert. Erscheint bei einem Richtliniensymbol, wenn eine Richtlinie deaktiviert ist. Richtlinien können mit der öffentlichen API deaktiviert werden. Siehe API-Proxy-Konfigurationsreferenz. |
|
| Fehler. Wird auf einem Richtliniensymbol angezeigt, wenn die Schrittbedingung „false“ ergibt (siehe Ablaufvariablen und Bedingungen), oder auf dem RaiseFault-Richtliniensymbol, wenn eine RaiseFault-Richtlinie ausgeführt wird. | |
| Übersprungen. Erscheint in einem Richtliniensymbol, wenn die Richtlinie nicht ausgeführt wurde, da die Schrittbedingung als „false“ ausgewertet wurde. Weitere Informationen finden Sie unter Ablaufvariablen und Bedingungen. |
Phasendetails verstehen
Der Teil Phasendetails des Tools teilt Ihnen mit jedem Verarbeitungsschritt viel über den Status Ihres Proxys mit. Im Folgenden finden Sie einige Details, die in den Phasendetails angegeben werden. Klicken Sie auf ein beliebiges Symbol im Trace-Tool, um Details für den ausgewählten Schritt anzuzeigen. Mit den Schaltflächen Weiter und Zurück können Sie von einem Schritt zu einem anderen wechseln.
| Phasendetails | Beschreibung |
| Proxy-Endpunkt | Gibt an, welcher ProxyEndpoint-Ablauf für die Ausführung ausgewählt wurde. Ein API-Proxy kann mehrere benannte Proxy-Endpunkte haben. |
| Variablen |
Listet die Ablaufvariablen auf, die von einer Richtlinie gelesen und denen ein Wert zugewiesen wurde. Weitere Informationen finden Sie unter Proxy-Status mit Ablaufvariablen verwalten. Hinweis:
|
| Anfrageheader | Listet die HTTP-Anfrageheader auf. |
| Inhalt anfragen | Zeigt den HTTP-Anfragetext an. |
| Eigenschaften | Attribute stellen den internen Status des API-Proxys dar. Diese werden nicht standardmäßig angezeigt. |
| Zielendpunkt | Gibt an, welcher TargetEndpoint für die Ausführung ausgewählt wurde. |
| Antwortheader | Listet die HTTP-Antwortheader auf. |
| Antwortinhalt | Zeigt den HTTP-Antworttext an. |
| PostClientFlow | Zeigt Informationen zum PostClientFlow an, der nach der Anfrage an die anfragende Clientanwendung ausgeführt wird. Nur MessageLogging-Richtlinien können an den PostClientFlow angehängt werden. Der PostClientFlow wird derzeit hauptsächlich zum Messen des Zeitintervalls zwischen den Start- und Endzeitstempeln für die Antwortnachricht verwendet. |
Nachrichtenerfassung mit Filtern optimieren
Sie können filtern, welche Anfragen im Trace-Tool angezeigt werden, indem Sie Header- und/oder Suchparameterwerte angeben. Mit Filtern können Sie bestimmte Aufrufe, die möglicherweise Probleme verursachen, gezielt untersuchen. Beispielsweise müssen Sie möglicherweise Anfragen mit bestimmten Inhalten oder Anfragen von bestimmten Partnern oder Apps genauer untersuchen. Sie können nach folgenden Kriterien filtern:
- HTTP-Header: Beschränken Sie den Trace auf Aufrufe, die einen bestimmten Header enthalten. Das ist eine gute Möglichkeit, Probleme zu beheben. Sie können einen Header an Ihren App-Entwickler senden und ihn bitten, ihn in den Aufruf einzufügen, der Probleme verursacht. Apigee Edge zeichnet dann nur Aufrufe mit diesem spezifischen Header auf, damit Sie die Ergebnisse prüfen können.
- Suchparameter: Es werden nur Aufrufe mit einem bestimmten Wert eines Parameters aufgezeichnet.
Wichtige Informationen zur Filterfunktion
- Sie müssen die Trace-Sitzung neu starten, nachdem Sie Filterparameter in den Filterfeldern angegeben haben.
- Filterparameter werden mit „AND“ verknüpft. Alle angegebenen Abfrage- und/oder Header-Name/Wert-Paare müssen in der Anfrage vorhanden sein, damit eine Übereinstimmung gefunden wird.
- Der Musterabgleich wird im Filtertool nicht unterstützt.
- Bei Filterparametern und -werten wird die Groß-/Kleinschreibung beachtet.
Trace-Filter erstellen
- Wenn eine Trace-Sitzung ausgeführt wird, beenden Sie sie, indem Sie auf Trace-Sitzung beenden klicken.
- Klicken Sie oben links im Trace-Tool auf Filter, um das Feld „Filter“ zu maximieren.

- Geben Sie im Feld „Filter“ die Suchparameter und/oder Headerwerte an, nach denen Sie filtern möchten. In diesem Beispiel geben wir zwei Suchparameter an, nach denen gefiltert werden soll. Beide Parameter müssen in der Anfrage vorhanden sein, damit eine Übereinstimmung gefunden wird.

- Starten Sie die Trace-Sitzung.
- Rufen Sie Ihre APIs auf. Nur Anfragen, die alle angegebenen Header und/oder Abfrageparameter enthalten, führen zu einer erfolgreichen Übereinstimmung.

Im obigen Beispiel wird dieser API-Aufruf in Trace angezeigt:
http://docs-test.apigee.net/cats?name=Penny&breed=Calico
Dies ist jedoch nicht der Fall:
http://docs-test.apigee.net/cats?name=Penny
Fehlerbehebung mit Trace
Mit Trace können Sie viele interne Details zu einem API-Proxy sehen. Beispiel:
- Sie können auf einen Blick sehen, welche Richtlinien ordnungsgemäß ausgeführt werden oder fehlschlagen.
- Angenommen, Sie haben in einem der Analytics-Dashboards festgestellt, dass die Leistung einer Ihrer APIs ungewöhnlich zurückgegangen ist. Jetzt können Sie mithilfe von Trace ermitteln, wo der Engpass auftritt. Trace gibt die Zeit in Millisekunden an, die jede einzelne Verarbeitungszeit benötigt. Wenn die Ausführung eines Schritts zu lange dauert, können Sie entsprechende Korrekturen vornehmen.
- In den Phasendetails können Sie Header überprüfen, die an das Backend gesendet werden, Variablen ansehen, die von Richtlinien festgelegt wurden, usw.
- Anhand des Basispfads können Sie prüfen, ob eine Richtlinie die Nachricht an den richtigen Server weiterleitet.
Ansichtsoptionen auswählen
Wählen Sie die Ansichtsoptionen für die Trace-Sitzung aus.

| Option | Beschreibung |
| Deaktivierte Richtlinien einblenden. | Deaktivierte Richtlinien anzeigen Richtlinien können mit der öffentlichen API deaktiviert werden. Siehe API-Proxy-Konfigurationsreferenz. |
| Übersprungene Phasen einblenden | Sie können alle übersprungenen Phasen einblenden. Eine übersprungene Phase tritt auf, wenn die Richtlinie nicht ausgeführt wurde, da die Schrittbedingung als „false“ ausgewertet wurde. Weitere Informationen finden Sie unter Ablaufvariablen und Bedingungen. |
| Alle Ablaufinformationen anzeigen | Übergänge innerhalb eines Ablaufsegments darstellen. |
| Ausgewählte Phase automatisch vergleichen | Vergleicht die ausgewählte Phase mit der vorherigen. Deaktivieren Sie diese Option, damit nur die ausgewählte Phase angezeigt wird. |
| Variablen anzeigen | Variablen anzeigen, die gelesen und/oder denen ein Wert zugewiesen wurde. |
| Attribute ansehen | Attribute stellen den internen Status des API-Proxys dar. (Standardmäßig ausgeblendet.) |
Trace-Ergebnisse werden heruntergeladen
Sie können eine XML-Datei mit den Rohdaten der Trace-Ergebnisse herunterladen, um sie offline in einem Texteditor anzusehen und zu durchsuchen. Die Datei enthält die vollständigen Details der Abhörsitzung, einschließlich des Inhalts aller Header, Variablen und Richtlinien.
Klicken Sie auf Trace-Sitzung herunterladen, um den Download zu starten.
Anfragen werden als curl angezeigt
Nachdem Sie einen API-Aufruf an einen Zielserver verfolgt haben, können Sie die Anfrage als curl-Befehl aufrufen. Das ist aus mehreren Gründen besonders nützlich für die Fehlerbehebung:
- Der API-Proxy kann die Anfrage ändern. Daher ist es hilfreich zu sehen, wie sich die Anfrage vom Proxy an den Zielserver von der ursprünglichen Anfrage unterscheidet. Der curl-Befehl stellt die geänderte Anfrage dar.
- Bei größeren Nachrichtennutzlasten können Sie mit curl die HTTP-Header und den Nachrichteninhalt an einem Ort sehen. (Derzeit gilt ein Limit von etwa 1.000 Zeichen. Einen Tipp, wie Sie dieses Limit umgehen können, finden Sie in diesem Community-Beitrag.)
Aus Sicherheitsgründen wird der HTTP-Autorisierungsheader durch die curl-Funktion maskiert.
Wenn Sie Anfragen als curl sehen möchten, nachdem ein API-Aufruf in Trace eingegangen ist, wählen Sie im Diagramm „Transaktionszuordnung“ die Phase „Anfrage an Zielserver gesendet“ aus und klicken Sie dann im Detailbereich „Phasendetails“ in der Spalte „Anfrage an Zielserver gesendet“ auf den Button curl anzeigen.

Verwendung des Apigee-Supports von Trace
Mit Apigee Edge kann der Apigee-Support standardmäßig das Trace-Tool auf Ihren API-Proxys verwenden, um Support zu bieten. Sie können diese Option jederzeit deaktivieren. Wenn Sie diese Option jedoch deaktivieren, ist der Support des Apigee-Supports eingeschränkt.
So deaktivieren Sie den Apigee-Support daran, das Trace-Tool zu verwenden:
- Melden Sie sich unter https://apigee.com/edge an.
- Wählen Sie in der linken Navigationsleiste Verwaltung > Datenschutz aus.
- Klicken Sie auf die Ein-/Aus-Schaltfläche Apigee-Support aktivieren , um die Verwendung des Trace-Tools durch den Apigee-Support zu deaktivieren.



