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

# AWS X-Ray サンプルアプリケーション
<a name="xray-scorekeep"></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)」を参照してください。

GitHub で利用可能な AWS X-Ray [eb-java-scorekeep](https://github.com/awslabs/eb-java-scorekeep/tree/xray) サンプルアプリケーションは、 AWS X-Ray SDK を使用して受信 HTTP コール、DynamoDB SDK クライアント、および HTTP クライアントを計測する方法を示しています。サンプルアプリケーションは を使用して DynamoDB テーブル CloudFormation を作成し、インスタンスで Java コードをコンパイルし、追加の設定なしで X-Ray デーモンを実行します。

[Scorekeep チュートリアル](scorekeep-tutorial.md)を参照して、 AWS マネジメントコンソール または を使用して、計測されたサンプルアプリケーションのインストールと使用を開始します AWS CLI。

![Scorekeep は AWS X-Ray SDK を使用して、受信 HTTP コール、DynamoDB SDK クライアント、HTTP クライアントを計測します。](http://docs.aws.amazon.com/ja_jp/xray/latest/devguide/images/scorekeep-flow.png)


サンプルには、フロントエンドのウェブアプリ、それが呼び出す API、データの保存に使用する DynamoDB テーブルが含まれています。[フィルター](xray-sdk-java-filters.md)、[プラグイン](xray-sdk-java-configuration.md)、および計測[された AWS SDK クライアントを使用した基本的な計測](xray-sdk-java-awssdkclients.md)は、プロジェクトの`xray-gettingstarted`ブランチに表示されます。これは、[入門ガイドチュートリアル](scorekeep-tutorial.md)でデプロイするブランチです。このブランチには基本情報しか含まれていないので、`master` ブランチと比較すると、基本をすばやく理解できます。

![](http://docs.aws.amazon.com/ja_jp/xray/latest/devguide/images/scorekeep-gettingstarted-servicemap-before-ECS.png)


同じアプリケーションで、次のファイルの基本計測も説明します。
+ **HTTP リクエストフィルタ**–[https://github.com/awslabs/eb-java-scorekeep/tree/xray/src/main/java/scorekeep/WebConfig.java](https://github.com/awslabs/eb-java-scorekeep/tree/xray/src/main/java/scorekeep/WebConfig.java)
+ **AWS SDK クライアントの計測** – [https://github.com/awslabs/eb-java-scorekeep/tree/xray/build.gradle](https://github.com/awslabs/eb-java-scorekeep/tree/xray/build.gradle)

アプリケーションの `xray` ブランチには、[HTTPClient](xray-sdk-java-httpclients.md)､[注釈](xray-sdk-java-segment.md)､[SQL クエリ](xray-sdk-java-sqlclients.md)、[カスタムサブセグメント](xray-sdk-java-subsegments.md)､実装された [AWS Lambda](xray-services-lambda.md) 関数､および[実装された初期化コードとスクリプト](scorekeep-startup.md)の使用が含まれています｡

ユーザーログインとブラウザでの AWS SDK for JavaScript の使用をサポートするために、`xray-cognito`ブランチはユーザーの認証と認可をサポートする Amazon Cognito を追加します。また、 Amazon Cognitoから認証情報を取得すると、ウェブアプリケーションはトレースデータをX-Rayに送信してクライアントの観点からリクエスト情報を記録します。ブラウザクライアントは、トレースマップ上に独自のノードとして表示され、ユーザーが表示しているページの URL やユーザーの ID などの追加情報を記録します。

最後に、 `xray-worker`ブランチは、個別に実行され、Amazon SQS キューの項目を処理する、実装された Python Lambda 関数を追加します。Scorekeep は、ゲームが終了するたびに項目をキューに追加します。CloudWatch Events によりトリガーされるLambda ワーカーは、数分ごとにキューから項目を取得し、それらの項目を処理して分析のためにゲームレコードをAmazon S3 に保存します。

**Topics**
+ [Scorekeep サンプルアプリケーションの開始方法](scorekeep-tutorial.md)
+ [AWS SDK クライアントの手動計測](scorekeep-sdkclients.md)
+ [追加のサブセグメントを作成する](scorekeep-subsegments.md)
+ [注釈、メタデータ、およびユーザー ID を記録する](scorekeep-annotations.md)
+ [送信 HTTP 呼び出しの計測](scorekeep-httpclient.md)
+ [PostgreSQL データベースに対する呼び出しの計測](scorekeep-postgresql.md)
+ [AWS Lambda 関数の計測](scorekeep-lambda.md)
+ [スタートアップコードの作成](scorekeep-startup.md)
+ [実装スクリプト](scorekeep-scripts.md)
+ [ウェブアプリケーションクライアントの実装](scorekeep-client.md)
+ [実装されたクライアントをワーカースレッドで使用する](scorekeep-workerthreads.md)