View a markdown version of this page

Instrumentation de scripts - AWS X-Ray

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Instrumentation de scripts

Note

X-Ray SDK/Daemon Avis de maintenance — Le 25 février 2026, ils AWS X-Ray SDKs/Daemon passeront en mode maintenance, où les versions du X-Ray SDK et de Daemon AWS seront limitées uniquement pour résoudre les problèmes de sécurité. Pour plus d'informations sur le calendrier de support, consultezChronologie du support pour le SDK et Daemon X-Ray. Nous vous recommandons de migrer vers OpenTelemetry. Pour plus d'informations sur la migration vers OpenTelemetry, consultez la section Migration de l' X-Ray instrumentation vers OpenTelemetry l'instrumentation.

Vous pouvez également instrumenter le code qui ne fait pas partie de l'application. Lorsque le X-Ray démon est en cours d'exécution, il relaie tous les segments qu'il reçoit X-Ray, même s'ils ne sont pas générés par le X-Ray SDK. Scorekeep utilise ses propres scripts pour instrumenter la build qui compile l'application pendant le déploiement.

Exemple bin/build.sh — Script de construction instrumenté
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 et xray_success.py sont de simples scripts Python qui construisent des objets de segment, les convertissent en documents JSON et les envoient au démon via UDP. Si la compilation de Gradle échoue, vous pouvez trouver le message d'erreur en cliquant sur le nœud scorekeep-build dans la carte de suivi de la console. X-Ray

Scorekeep-build nœud affichant une durée moyenne de 14,8 secondes et 0,07 transactions par minute.
Détails du suivi montrant une demande d'une durée de 14,6 secondes avec visualisation de la chronologie.
Onglet Exceptions indiquant un échec de construction avec une erreur concernant ElasticBeanstalkPlugin le symbole manquant.