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

-AWSX-Rayeb-java-scorekeepGitHub で利用可能なサンプルアプリは、AWSX-Ray SDK を使用して、受信 HTTP 呼び出し、DynamoDB SDK クライアント、および HTTP クライアントを計測します。このサンプルアプリケーションではAWS Elastic BeanstalkDynamoDB テーブルを作成し、Java コードをオンインスタンスでコンパイルして、設定を追加せずに X-Ray デーモンを実行します。

このサンプルは、AWSLabs にある Scorekeep プロジェクトの計測済みバージョンです。これには、フロントエンドのウェブアプリケーション、それが呼び出す API、データの保存に使用する DynamoDB テーブルが含まれています。移植しやすくデプロイが簡単なように、コンポーネントはすべて Elastic Beanstalk 環境でホストされます。

での基本的な計測フィルター,プラグイン, および計装されたAWSクライアント SDKは、プロジェクトのxray-gettingstartedブランチ。これは、入門ガイドチュートリアルでデプロイするブランチです。このブランチには基本情報しか含まれていないので、master ブランチと比較すると、基本をすばやく理解できます。

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

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

• AWSSDK クライアント計測–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 イベントによってトリガーされる Lambda ワーカーは、数分ごとにキューから項目を取得し、それらを処理して分析のために Amazon S3 にゲームレコードを格納します。

X-Ray でサンプルアプリケーションを使用する手順については、入門チュートリアル。チュートリアルで説明されている X-Ray SDK for Java の基本的な使用方法に加えて、サンプルでは次の機能の使用方法も説明しています。

拡張機能

• AWS CLI から AWS X-Ray の使用を開始する
• 手動計測AWSSDK クライアント
• 追加のサブセグメントを作成する
• 注釈、メタデータ、およびユーザー ID を記録する
• 送信 HTTP 呼び出しの計測
• PostgreSQL データベースに対する呼び出しの計測
• AWS Lambda 関数を実装する
• スタートアップコードの作成
• 計測スクリプト
• ウェブアプリケーションクライアントの実装
• 実装されたクライアントをワーカースレッドで使用する