View a markdown version of this page

Instrumentieren von Skripten - 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.

Instrumentieren von Skripten

Anmerkung

X-Ray SDK/Daemon Wartungshinweis — Am 25. Februar 2026 wechselt der AWS X-Ray SDKs/Daemon in den Wartungsmodus, in dem X-Ray SDK- und Daemon-Versionen auf Sicherheitsprobleme beschränkt AWS werden. 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 Instrumentation zu OpenTelemetry Instrumentation.

Sie können auch Code instrumentieren, der nicht Teil Ihrer Anwendung ist. Wenn der X-Ray Daemon läuft, leitet er alle empfangenen Segmente weiter X-Ray, auch wenn sie nicht vom SDK generiert wurden. X-Ray Scorekeep nutzt seine eigenen Skripte zur Instrumentierung des Builds, der die Anwendung während der Bereitstellung kompiliert.

Beispiel bin/build.sh — Instrumentiertes Build-Skript
SEGMENT=$(python bin/xray_start.py)
gradle build --quiet --stacktrace &> /var/log/gradle.log; GRADLE_RETURN=$?
if (( GRADLE_RETURN != 0 )); then 
  echo "Gradle failed with exit status $GRADLE_RETURN" >&2
  python bin/xray_error.py "$SEGMENT" "$(cat /var/log/gradle.log)"
  exit 1
fi
python bin/xray_success.py "$SEGMENT"

xray_start.py, xray_error.py und xray_success.py sind einfache Python-Skripte, die Segmentobjekte erstellen, diese in JSON-Dokumente konvertieren und über UDP an den Daemon senden. Wenn der Gradle-Build fehlschlägt, können Sie die Fehlermeldung finden, indem Sie in der Trace-Map der Konsole auf den Scorekeep-Build-Knoten klicken. X-Ray

Scorekeep-build Knoten mit einer durchschnittlichen Dauer von 14,8 Sekunden und 0,07 Transaktionen pro Minute.
Trace-Details, die eine Anfrage mit einer Dauer von 14,6 Sekunden mit Zeitleistenvisualisierung zeigen.
Die Registerkarte „Ausnahmen“ zeigt einen Build-Fehler und eine Fehlermeldung bezüglich eines fehlenden ElasticBeanstalkPlugin Symbols an.