View a markdown version of this page

Scripts de instrumentação - AWS X-Ray

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Scripts de instrumentação

nota

X-Ray SDK/Daemon Aviso de manutenção — Em 25 de fevereiro de 2026, AWS X-Ray SDKs/Daemon ele entrará no modo de manutenção, onde AWS limitará os lançamentos do X-Ray SDK e do Daemon para tratar apenas de problemas de segurança. Para obter mais informações sobre a linha do tempo do suporte, consulte Cronograma de suporte do X-Ray SDK e do Daemon Support. Recomendamos migrar para o. OpenTelemetry Para obter mais informações sobre como migrar para OpenTelemetry, consulte Migração da X-Ray instrumentação para a instrumentação. OpenTelemetry

Você também pode instrumentar código que não faz parte de seu aplicativo. Quando o X-Ray daemon está em execução, ele retransmite todos os segmentos que recebe X-Ray, mesmo que não sejam gerados pelo SDK. X-Ray O Scorekeep usa seus próprios scripts para instrumentar o build que compila o aplicativo durante a implantação.

exemplo bin/build.sh — Script de construção instrumentado
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 and xray_success.py são scripts simples do Python que constroem objetos de segmento, convertem-nos em documentos JSON e envia-os para o daemon por meio de UDP. Se a compilação do Gradle falhar, você poderá encontrar a mensagem de erro clicando no nó scorekeep-build no mapa de rastreamento do console. X-Ray

Scorekeep-build nó mostrando duração média de 14,8 segundos e 0,07 transações por minuto.
Rastreie detalhes mostrando uma solicitação de duração de 14,6 segundos com visualização da linha do tempo.
Aba de exceções mostrando falha de compilação com erro sobre o ElasticBeanstalkPlugin símbolo ausente.