翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 実装スクリプト
<a name="scorekeep-scripts"></a>

**注記**  
X-Ray SDK/デーモンメンテナンス通知 – 2026 年 2 月 25 日、 AWS X-Ray SDKsデーモンはメンテナンスモードに移行します。 AWS では、X-Ray SDK とデーモンのリリースがセキュリティの問題にのみ対処するように制限されます。サポートタイムラインの詳細については、「[X-Ray SDK とデーモンのサポートタイムライン](xray-sdk-daemon-timeline.md)」を参照してください。OpenTelemetry に移行することをお勧めします。OpenTelemetry への移行の詳細については、「[X-Ray による計装から OpenTelemetry による計装への移行](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html)」を参照してください。

また、アプリケーションの一部ではないコードを計測することもできます。X-Ray デーモンが実行されている場合、X-Ray SDK によって生成されない場合でも、デーモンは受信したすべてのセグメントを X-Ray に中継します。Scorekeep は独自のスクリプトを使用して、展開中にアプリケーションをコンパイルするビルドを実装します。

**Example [`bin/build.sh`](https://github.com/awslabs/eb-java-scorekeep/tree/xray/bin/build.sh) – 実装されたビルドスクリプト**  

```
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`](https://github.com/awslabs/eb-java-scorekeep/tree/xray/bin/xray_start.py)､[`xray_error.py`](https://github.com/awslabs/eb-java-scorekeep/tree/xray/bin/xray_error.py)､および [`xray_success.py`](https://github.com/awslabs/eb-java-scorekeep/tree/xray/bin/xray_success.py) は、セグメントオブジェクトを構築し、JSON 文書に変換し、UDP 経由でデーモンに送信する単純な Python スクリプトです。Gradle のビルドに失敗した場合は、X-Ray コンソールトレースマップの **[scorekeep-build]** ノードをクリックして、エラーメッセージを見つけることができます。

![Scorekeep-build ノードは、平均所要時間が 14.8 秒、トランザクションが 1 分あたり 0.07 件です。](https://docs.aws.amazon.com/ja_jp/xray/latest/devguide/images/scorekeep-servicemap-builderror.png)


![タイムラインを視覚化した 14.6 秒の期間リクエストを示すトレースの詳細。](https://docs.aws.amazon.com/ja_jp/xray/latest/devguide/images/scorekeep-timeline-builderror.png)


![ElasticBeanstalkPlugin 記号の欠落に関するエラーを伴うビルド失敗を示す例外タブ。](https://docs.aws.amazon.com/ja_jp/xray/latest/devguide/images/scorekeep-exception-builderror.png)