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

只有客户可以触发调试会话，但 Apigee 支持团队可以在处理支持请求的过程中访问未删除的过往调试会话，以帮助排查特定于代理的问题。

请注意以下事项：

  • Apigee 支持团队拥有对调试数据的只读权限。
  • Apigee 支持人员可能会要求您运行调试来捕获问题的相关信息，并提供调试会话 ID 或调试会话的链接，以便支持人员可以查看捕获的调试。由于保存的调试会话的有效时间仅有 24 小时，我们建议您下载调试会话并将其附加到创建的案例中，供支持人员离线查看。

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