AWS X-Ray サンプルアプリケーション

注記

End-of-support通知 – 2027 年 2 月 25 日、 AWS X-Ray は AWS X-Ray SDKs とデーモンのサポートを終了します。2027 年 2 月 25 日以降、更新やリリースは配信されなくなります。サポートタイムラインの詳細については、「」を参照してくださいX-Ray SDK とデーモンのサポート終了タイムライン。OpenTelemetry に移行することをお勧めします。OpenTelemetry への移行の詳細については、「X-Ray 計測から OpenTelemetry 計測への移行」を参照してください。

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

Scorekeep チュートリアルを参照して、 AWS Management Console または を使用して、計測されたサンプルアプリケーションのインストールと使用を開始します AWS CLI。

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

同じアプリケーションで、次のファイルの基本計測も説明します。

• HTTP リクエストフィルタ–WebConfig.java

• AWS SDK クライアント計測 – build.gradle

アプリケーションの xray ブランチには、HTTPClient､注釈､SQL クエリ、カスタムサブセグメント､実装された AWS Lambda 関数､および実装された初期化コードとスクリプトの使用が含まれています｡

ユーザーのログインとブラウザでの 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 に保存します。

トピック

• Scorekeep サンプルアプリケーションの開始方法

• AWS SDK クライアントの手動計測

• 追加のサブセグメントを作成する

• 注釈、メタデータ、およびユーザー ID を記録する

• 送信 HTTP 呼び出しの計測

• PostgreSQL データベースに対する呼び出しの計測

• AWS Lambda 関数の計測

• スタートアップコードの作成

• 実装スクリプト

• ウェブアプリケーションクライアントの実装

• 実装されたクライアントをワーカースレッドで使用する