View a markdown version of this page

Erste Schritte mit X-Ray - AWS X-Ray

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erste Schritte mit X-Ray

Anmerkung

X-Ray SDK/Daemon Wartungshinweis — Am 25. Februar 2026 wechselt der in den AWS X-Ray SDKs/Daemon Wartungsmodus, in dem die X-Ray SDK- und Daemon-Versionen begrenzt AWS werden, um ausschließlich Sicherheitsprobleme zu beheben. Weitere Informationen zum Zeitplan für den Support finden Sie unter. Zeitplan für die Support von X-Ray SDK und Daemon Wir empfehlen die Migration zu OpenTelemetry. Weitere Informationen zur Migration zu OpenTelemetry finden Sie unter Migration von X-Ray Instrumentierung zu OpenTelemetry Instrumentierung.

Gehen Sie zur Verwendung X-Ray wie folgt vor:

  1. Instrumentieren Sie Ihre Anwendung, sodass X-Ray Sie verfolgen können, wie Ihre Anwendung eine Anfrage bearbeitet.

    • Verwenden Sie die X-Ray SDKs, X-Ray APIs ADOT oder CloudWatch Anwendungssignale, um Trace-Daten an diese zu X-Ray senden. Weitere Informationen darüber, welche Schnittstelle Sie verwenden sollten, finden Sie unterAuswahl einer Schnittstelle.

    Weitere Hinweise zur Instrumentierung finden Sie unterInstrumentierung Ihrer Anwendung für AWS X-Ray.

  2. (Optional) Konfigurieren Sie X-Ray es so, AWS-Services dass es mit anderen Geräten zusammenarbeitet, die mit integriert sind X-Ray. Sie können Traces testen und eingehenden Anfragen Header hinzufügen, einen Agenten oder Collector ausführen und automatisch Trace-Daten an diese X-Ray senden. Weitere Informationen finden Sie unter Integration AWS X-Ray mit anderen AWS-Services.

  3. Stellen Sie Ihre instrumentierte Anwendung bereit. Wenn Ihre Anwendung Anfragen erhält, zeichnet das X-Ray SDK Trace-, Segment- und Subsegmentdaten auf. In diesem Schritt müssen Sie möglicherweise auch eine IAM-Richtlinie einrichten und einen Agenten oder Collector bereitstellen.

    • Beispielskripte zur Bereitstellung einer Anwendung mithilfe des SDK von AWS Distro for OpenTelemetry (ADOT) und des CloudWatch Agenten auf verschiedenen Plattformen finden Sie unter Anwendungssignal-Demoskripts.

    • Ein Beispielskript für die Bereitstellung einer Anwendung mithilfe des X-Ray SDK und des X-Ray Daemons finden Sie unter. AWS X-Ray Beispielapplikation

  4. (Optional) Öffnen Sie eine Konsole, um die Daten anzuzeigen und zu analysieren. Sie können eine grafische Darstellung einer Trace-Map, einer Service-Map und mehr sehen, um zu überprüfen, wie Ihre Anwendung funktioniert. Verwenden Sie die grafischen Informationen in der Konsole, um Ihre Anwendung zu optimieren, zu debuggen und zu verstehen. Weitere Informationen zur Auswahl einer Konsole finden Sie unterBenutze eine Konsole.

Das folgende Diagramm zeigt die ersten Schritte mit der Verwendung von X-Ray:

X-Ray zeigt detaillierte Informationen zu Anwendungsanfragen an, einschließlich Status, Dauer und HTTP-Antwortcode.

Ein Beispiel für die Daten und Karten, die in der Konsole verfügbar sind, erhalten Sie, wenn Sie eine Beispielanwendung starten, die bereits für die Generierung von Trace-Daten ausgestattet ist. In wenigen Minuten können Sie Traffic generieren, Segmente an diese X-Ray senden und eine Trace- und Service-Map anzeigen.