AWS Certified Developer – Associate(DVA) を勉強中です。
AWS X-Rayは使ったことがなく全くわからないので、まずは公式のチュートリアルでなんとなーくどんなサービスなんだろうという雰囲気を感じたいと思います。
公式サイトを参考に進めました。
チュートリアルアプリを展開
マネジメントコンソールの検索窓から「X-Ray」と検索し、表示されたページの「デモアプリをセットアップ」をクリックします。
「CloudFormation を使用してサンプルアプリケーションを作成」をクリック
設定は変更せず「次へ」をクリック
![[スタックの作製]ページのスクリーンショット画像](https://npama.com/wp-content/uploads/2025/09/image-17.png)
スタック名は好きな名前を入力します。
色々パラメーターを設定できますが、全てデフォルトで下までスクロールし「次へ」をクリック
スタックオプションもデフォルトのまま。
「AWS CloudFormation によって IAM リソースがカスタム名で作成される場合があることを承認します。」にチェックを付けて、「次へ」をクリック
設定の確認画面が表示されます。一番下までスクロールして「送信」をクリックします。
チュートリアルアプリの展開が始まります。5分ほどで完了しました。
クリックだけでできたので簡単でした。
アプリで遊ぶ
CloudFormationの「出力」タブをクリックし、LoadBalancerUrlの値をクリックします
アプリの画面が表示されます。
そのまま「Create」をクリックすると、ランダムな名前でユーザーとセッションが作成されるようです。
「game name」を入力し、「Rules」を「Tic Tac Toe」 に設定したら、[Create] を選択して、ゲームを作成します。
※Tic Tac Toeは、日本で言う○×ゲームのようです。
「Play」をクリックして、ゲームを開始します。
タイルをクリックすると、API にHTTPリクエストが送られ、更に DynamoDB に対してデータの読み書きが行われているようです。
1人で適当に遊んでおきました。
X-Rayを確認する
サンプルアプリケーションによって生成されたトレースマップとトレースを確認します。
X-RayコンソールはCloudWatchと統合されたようで、「CloudWatch」→ Application Signals(APM)の「トレース」をクリックすることで、トレースマップを確認できます。
以下のトレースマップの意味は、クライアントからのリクエストがECSに届いて、ECSはそのリクエストを受けてDynamoDBへのリクエストを行ったということだと思います。
トレースマップは、X-Rayといえばこんな事ができます～って、真っ先に紹介される機能な気がしますね。
もう少し時間範囲を広げると、SNSのノードが黄色（エラー4xx)になっていることがわかります。
ここからは、X-Rayでどのように、このエラーの原因を掘り下げるのかを見ていきます。
X-Rayでエラーの調査
SNSのノードをクリックすると詳細が表示されるので「トレースを表示」をクリック
トレースをクリック
「障害」と表示されている横の「View exception」をクリックすると、セグメントの詳細が表示されます。詳細画面の「例外」タブをクリックすると、下部にスタックトレースが表示されています。
このスタックトレースはX-Ray SDKにより取得されたもので、AWS SDK クライアントによってスローされた例外を自動的にキャプチャしたもののようです。
※X-Ray SDKとAWS SDKは名前が似てますが別物として区別します。
このスタックトレースから読み取れるエラーの原因は以下のようです。
この原因は、
WebConfigクラスで行われたcreateSubscriptionの呼び出しで指定された E メールアドレスが無効であることを意味します。
要はCloud Formationでアプリを展開する時に、SNS通知用のメールアドレスを設定しなかったから発生したエラーのようです。
このようにX-Rayではエラーの調査ができる。という話かな。
アプリを修正する
CloudFormationのページでxray-sampleのスタックを開きます。
「スタックを更新」→「直接更新を実行」をクリックします。
Emailの項目を探して自分のメールアドレスを入力します。
ページの下部にスクロールし、「次へ」
「CloudFormation によってカスタム名がついた IAM リソースが作成される場合があることを承認します」 チェックボックスをONして、「次へ」
「送信」をクリックすると、アプリの更新が始まります。5分ほどで完了します。
更新が完了すると、設定したメールアドレスにSNSのSubscriptionの確認メールが来るのでリンクをクリックしてSubscriptionしておきます。
アプリで遊ぶ
今度はゲーム名をxray-tutorial2として遊びました。
勝ちました。
今度はメールが届いていました。
X-Rayを確認する
トレースを確認すると、POSTとGETのリクエストが来ており、全て成功していることがわかりました。応答時間なども一覧で見れて、極端に遅延が発生していないこともわかりますね。
トレースをクリックして開いてみました。
ズラッとタイムラインが出てきたのですが、以下の理解です。
1番行目：処理の概要。ECSで受け取ったPOSTリクエストを84ミリ秒かけて処理した
2行目以降：処理の内訳。ECSで受け取ったリクエストを返すために、どんな処理を内部でしたか。キャプチャの例でいうと、DynamoDBからItemをGetしたりUpdateしたりSNSで通知を送ったりした。
さらに、セグメントをクリックすると、詳細が確認できます。
リクエストの開始・終了時間、リクエストURL、メソッド、セグメントIDが書いてありました。
チュートリアルアプリを削除
展開したチュートリアルアプリを削除します。
CloudFormationページに行き、チュートリアルアプリのタスクのラジオボタンを選択し、「削除」をクリックします。
確認画面が表示されますが、そのまま「削除」
削除が開始されます。ステータスは削除が完了するまで「DELETE_IN_PROGRESS」になります。
コスト
朝10時くらいにチュートリアルアプリを展開して、夜12時頃に削除しました。
アプリで遊んだのは3,4回で、コストは$0.14程でした。
安価なので、ちょっとした機能の確認も気軽にできて良いですね。
感想
- 実際に触ることでAWS X-Rayの雰囲気を掴めた
- ただし、雰囲気でX-Ray画面を操作している程度
- よく意味がわかっていないワードが多く、こういう意味かな？と推測で使っている。
（例：セグメント、トレース、サービスマップ）
今後の展望
- X-Rayで登場するワードの理解
- X-Rayの全体構造の理解
コメント