20200526 AWS Black Belt Online Seminar AWS X-Ray

© 2020, Amazon Web Services, Inc. or its Affiliates. All rights reserved.
AWS 公式 Webinar
https://amzn.to/JPWebinar
過去資料
https://amzn.to/JPArchive
Solutions Architect 鈴木太一郎
2020/5/26
AWS X-Ray
サービスカットシリーズ
[AWS Black Belt Online Seminar]

自己紹介
鈴木太一郎
所属
• アマゾンウェブサービスジャパン株式会社
技術統括本部
• ソリューションアーキテクト
好きなサービス
• AWS X-Ray
• AWS CDK

AWS Black Belt Online Seminar とは
「サービス別」「ソリューション別」「業種別」のそれぞれのテーマに分かれて、アマゾ
ンウェブサービスジャパン株式会社が主催するオンラインセミナーシリーズです。
質問を投げることができます！
• 書き込んだ質問は、主催者にしか見えません
• 今後のロードマップに関するご質問は
お答えできませんのでご了承下さい
① 吹き出しをクリック
② 質問を入力
③ Sendをクリック
Twitter ハッシュタグは以下をご利用ください
#awsblackbelt

内容についての注意点
• 本資料では2020年5月26日時点のサービス内容および価格についてご説明しています。最新の
情報はAWS公式ウェブサイト(http://aws.amazon.com)にてご確認ください。
• 資料作成には十分注意しておりますが、資料内の価格とAWS公式ウェブサイト記載の価格に相
違があった場合、AWS公式ウェブサイトの価格を優先とさせていただきます。
• 価格は税抜表記となっています。日本居住者のお客様には別途消費税をご請求させていただきま
す。
• AWS does not offer binding price quotes. AWS pricing is publicly available and is
subject to change in accordance with the AWS Customer Agreement available at
http://aws.amazon.com/agreement/. Any pricing information included in this
document is provided only as an estimate of usage charges for AWS services based on
certain information that you have provided. Monthly charges will be based on your
actual use of AWS services, and may vary from the estimates provided.

アジェンダ
• AWS X-Ray とは
• AWS X-Ray の概念
• AWS X-Ray によるアプリケーション分析
• AWS X-Ray によるデータ収集の仕組み
• AWS X-Ray の利用方法
• Amazon CloudWatch との連携
• 料金・注意点
• まとめ

• モノリシックアプリケーション
 多数の機能を1プロセスで稼働
• マイクロサービスアプリケーション
 少数のまとまった機能を持つ複数のサービスで構成
 各サービスが独立したプロセスとして稼働
 サーバレスやコンテナと相性が良い
モノリシック vs マイクロサービス

モノリシック vs マイクロサービス
• モノリシックアプリケーション
 大規模アプリでは、高速なイテレーションが難しい
 効率的なスケールが難しい
 不具合や障害が全体に影響
• マイクロサービスアプリケーション
 各サービスで独立した開発・デプロイ
 各サービスで独立したスケーリング
 障害の直接的な影響が各サービス内

マイクロサービスにおける障害対応・パフォーマンス分析
• 障害発生時の原因究明
• ログが分散・それぞれ独自のフォーマット
• 依存しあう多数の多様なサービス群
• パフォーマンス分析が難しい
• ボトルネックのサービスはどこなのか
• 日々変化するサービス間の依存関係と全体像

AWS X-Ray の概要
アプリケーションやその基盤となるサービスの実行状況を把握し
パフォーマンスの問題やエラーの根本原因を特定する

AWS X-Ray のメリット
リクエスト実行状況の確認
アプリケーションを構成する
個々のサービスやリソースの
実行結果ステータスを集計し、
アプリケーションの実行状況を
End-to-End で確認可能
アプリケーションの問題の検出
アプリケーションの実行状況に
ついての関連する情報を収集し、
問題の根本原因を調査可能
アプリケーションのパフォーマンス向上
サービスやリソースの関係をリアルタイムで
表示し、レイテンシ増加やパフォーマンス低下
などのボトルネックを特定可能
AWSとの連携
Amazon EC2, Amazon ECS,
AWS Lambda, AWS Elastic Beanstalk
などと連携
さまざまなアプリケーション向けの設計
非同期のシンプルなイベント呼び出し、
３層のウェブアプリケーション、数千の
サービスから構成される複雑なマイクロ
サービスも分析可能

AWS X-Ray の概念
AWS Lambda
Amazon DynamoDB
AWS Lambda が Amazon DynamoDB を3回呼び出し

AWS X-Ray の概念
セグメント
動作に関するデータ
• リソース名
• リクエストの詳細
• 行った作業の詳細
Amazon DynamoDB
AWS Lambda

AWS X-Ray の概念
セグメント
サブセグメント
呼び出しに関する追加の詳細な情報
• AWS のサービス
• 外部 HTTP API
• SQL データベース
• など
Amazon DynamoDB
AWS Lambda

AWS X-Ray の概念
セグメント
Amazon API Gateway Amazon API Gateway AWS Fargate
Amazon S3
エンドユーザー
Amazon DynamoDB
AWS Lambda

AWS X-Ray の概念
セグメント
トレース
1つのリクエストで生成されたセグメントの全てを収集したもの
Amazon DynamoDB
AWS Lambda
Amazon S3
Amazon API Gateway Amazon API Gateway AWS Fargate

セグメント
Lambda
DynamoDB
API Gateway API Gateway Fargate
S3
トレース
• どのようにトレースが含むセグメントを管理している？
• セグメントのつながり・順序はどう管理している？
AWS X-Ray の概念

AWS X-Ray の概念
どのようにトレースが含むセグメントを管理している？
• トレース ID
• リクエストを追跡するための ID
• リクエストごとに一意
• 基本的に最初にセグメントを生成するタイミングで生成
セグメント
トレース ID
(B)
セグメント
トレース ID
(B)
セグメント
トレース ID
(A)
トレース (B)
セグメント
トレース ID
(B)
セグメント
トレース ID
(B)
トレース (A)
セグメント
トレース ID
(A)
セグメント
トレース ID
(A)
AWS LambdaAmazon API Gatway
セグメント
トレース ID
(A)

AWS X-Ray の概念
セグメントのつながり・順序はどう管理している？
• セグメント ID
• トレース内のセグメントに対して一意に決まる
• 単一のサービスのリクエストを追跡するための ID
• 親セグメント ID によってセグメントのつながり・順序が決まる
セグメント (A)
親セグメント ID (B)
セグメント (C)
親セグメント ID (A)
セグメント (B)
セグメント (A)
親セグメント ID (B)
セグメント (C)
親セグメント ID (A)
セグメント (B)
トレーストレース
リクエストの流れ

AWS X-Ray の概念
セグメント同士のつながりや順序はどう管理している？
• セグメント ID
• 単一のサービスのリクエストを追跡するためのID
• 親セグメント ID によってセグメントのつながりが決まる
セグメント
親セグメント
ID
セグメント
親セグメント
ID セグメント
セグメント
親セグメント
ID
セグメント
親セグメント
ID
セグメント
トレーストレース
トレース ID やセグメント ID をどう伝搬している？

X-Amzn-Trace-Id: Root=1-
57…93;Parent=53…d8;Sampled=1
AWS X-Ray の概念
トレース ID やセグメント ID をどう伝搬している？
• トレースヘッダー
• トレース ID、親セグメントID、サンプリングデシジョンが定義された
HTTP ヘッダー
トレース ID
親セグメント ID
サンプルデシジョンサンプリング対象か否か (1=true, 0=false)

AWS X-Ray の概念
セグメントに情報を追加したい
検索しやすくするため
• 注釈
• フィルタ式 (後述) で使用するためインデックス化されたキーと値のペ
ア
• 例 "aws:api_stage": "prod"
デバッグや分析のため
• メタデータ
• 任意のタイプの値を持つことができるキーと値のペア
• フィルタ式で使用するためのインデックスは作成されない
• 例 "game": {"id": "abcdefg", "session": "xxxyyyzzz"}

AWS X-Ray によるアプリケーション分析
サービスマップ
トレースデータの可視化
トレースリスト
トレースの詳細な情報
アナリティクス
トレース分析用ツール
特定のサービスに関連する
トレースリストの確認
特定のサービスに関連する
トレースリストを分析
分析対象のトレースリストの
詳細を確認
End-to-End のリクエストの確認

• 読み取れる情報
• フィルタ式
• グループ
トレースリストアナリティクス

• 成功した呼び出し
• 4xx エラー
• 5xx エラー
• スロットリングエラー
平均レイテンシ (ms)
トレース数
(trace/min)
サービス名
サービスの分類

クリック
アナリティクストレースリスト

フィルタ式
• トレースを絞り込むための機能
• トレースリストとアナリティクスで利用可能
• duration >= 5 AND duration <= 8 総所要時間が5秒〜8秒
• http.status != 200 レスポンスステータスが 200 OK ではない
• service(name) { filter } 特定のサービスを含んだリクエスト
• edge(source, destination) { filter } 特定のサービス間の接続
https://docs.aws.amazon.com/ja_jp/xray/latest/devguide/xray-console-
filters.html

• トレースを絞り込むための機能
• トレースリストとアナリティクスで利用可能
• duration >= 5 AND duration <= 8 総所要時間が5秒〜8秒
• http.status != 200 レスポンスステータスが 200 OK ではない
• service(name) { filter } 特定のサービスを含んだリクエスト
• edge(source, destination) { filter } 特定のサービス間の接続
フィルタ式
filters.html
クリッククリック

• グループ
• フィルタ式で定義されるトレースのコレクション
• サービスマップ、トレースリスト、アナリティクスで利用可能
• Amazon CloudWatch にメトリクスを作成 (トレース数)
グループ
filters.html

• トレースリスト
• セグメント・サブセグメント
• カスタムサブセグメント
• セグメント詳細

URL

クリック

セグメント・サブセグメント
セグメント

カスタムサブセグメント
カスタムサブセグメント
監視・計測したい機能ごとにサブセグメントとして切り出すことが可能

セグメント詳細
クリック

概要注釈例外
リソースメタデータ
セグメント情報
時間情報
エラー情報
リクエスト
レスポンス詳細

アナリティクス
• フィルタリングされたトレースセット
• 応答時間の分布
• 時系列アクティビティ
• メトリクステーブル
• ワークルフローの例

フィルタリングされたトレースセット
• グラフやテーブルに対して操作を行いアナリティクス内に作成
• 最大で2つ ( A と B ) まで作成可能
• トレースセットを活用することで素早い分析が可能
グラフに対してドラッグテーブルに対して選択
全てのトレース
グループ
フィルタリングの結果
フィルタリングされたトレースセット A
フィルタリングされたトレースセット B
アナリティクスで可視化されるトレース

応答時間の分布
• 指定された応答時間におけるトレース数を示すグラフ
• 横軸応答時間
• 縦軸トレース数
• ドラッグすることでフィルタリングされたトレースセットを作成できる
ドラッグ

• 指定された時間のトレース数
• 横軸時間
• 濃さトレース数 (濃い方が多い)
• ドラッグすることでフィルタリングされたトレースセットを作成できる
時系列アクティビティ
ドラッグ

• Http Status Code や Response Time Root Cause など事前に定義された属性に
基づき分類されたトレース
• テーブルの行をクリックすることでフィルタリングされたトレースセット
として設定可能
メトリクステーブル
クリック

• テーブルの属性は変更可能
• 注釈も指定できる
メトリクステーブル
クリック

アナリティクスを用いたワークフローの例
1. リリースが応答時間に影響を与えていないか確認
• リリースした機能によってパフーマンスが悪化した場合
• パフォーマンス改善のリリースが効果的か調べる場合
2. 応答時間と時間帯に相関があるか調べる
• サービスの負荷が高まる時間帯に応答時間が長くなっていないか調べる場合

ワークフローの例 ①
リリースが応答時間に影響を与えていないか確認したい

時系列アクティビティにてリリース後の期間をドラッグし
フィルタリングされたトレースセット A を作成
ドラッグ
リリースしたタイミング

応答時間の分布を確認し応答時間に影響がないことを確認
偏りがない

Http Status Code のテーブルを確認すれば
リリースがエラーを起こしていないか確認できる

ワークフローの例 ②
応答時間と時間帯に相関があるか調べる

応答時間の早いトレースセット A を作成
ドラッグ

応答時間の遅いトレースセット B を作成
ドラッグ

時系列アクティビティを確認し
分布に偏りがないことから時間との相関はないと判断
偏りがない

サンプリング
• サンプリングとは
• サンプリングの作成
• ルール名・優先度
• リザーバサイズ・固定レート
• 一致基準

サンプリングとは
• AWS X-Ray ではサンプリングルールに従い記録されるリクエストが決まる
• デフォルトのサンプリングルール
• 1秒ごとに最初のリクエストは必ずトレースされる
• それ以降のリクエストについては全体の5%がトレースされる
• なぜサンプリングが必要？
• 課金額のコントロール
• パフォーマンスへの影響をコントロール
• 設定方法
• コンソール
• ローカルルール ( SDK から設定を読み込む )
今からご紹介

サンプリングの作成

全ての条件に一致
ルールが適応されたトレース数

クリック

ルール名・優先度
値が低い方が優先的に適応
デフォルトのルールは10000

リザーバサイズ・固定レート
デフォルトはリザーバサイズ= 1 固定レート=5%
• リザーバサイズ 1秒間で必ず記録するトレース数
• 固定レートリザーバサイズを超えたリクエスト数のうち何%を記録するか
リザーバサイズ=50 固定レート=10%
1秒あたり100件のリクエストがルールに一致する場合
50 (リザーバーサイズ) + 50 x 0.1 (固定レート) = 55 リクエスト
例

一致基準
例: AWS::APIGateway::Stage
例: POST
例: /api/
例: arn:aws:execute-api…
例: webserver.mydomain.com
例: MyApplication

AWS X-Ray のデータ収集の仕組み
スクリプトやツール
AWS SDK AWS CLI
AWS X-Ray SDK
アプリケーション
AWS X-Ray API
AWS X-Ray コンソール
AWS X-Ray デーモン

AWS SDK AWS CLI
AWS X-Ray SDK
AWS X-Ray API
アプリケーションで作成したセグメントデータを
X-Ray デーモンに送信

AWS X-Ray SDK
Java
Node.js
.Net
Ruby
Go
Python
• トレースデータを作成して X-Ray デーモンに送信するた
めのクラスとメソッドを提供
• 受信リクエスト
• AWS SDK クライアント (Amazon DynamoDB, Amazon
S3, …)
• 送信 HTTP 呼び出し
• SQL クエリ
• カスタムサブセグメント
• …
AWSX-Ray SDK

AWS SDK AWS CLI
AWS X-Ray SDK
AWS X-Ray API
X-Ray デーモンはセグメントデータを
バッファリングし X-Ray API に定期的に転送

• 未加工のセグメントデータを収集して AWS X-Ray API に送信
• UDP ポート 2000 (デフォルト) をリッスン
• 受信したデータをバッファリングして X-Ray API に送信する
• 実行方法
• Linux 実行可能ファイル, RPMパッケージ, DEBパッケージ
• OS X 実行可能ファイル
• Windows 実行可能ファイル, サービス
• AWS Lambda コンソールから設定
• AWS Elastic Beanstalk コンソールから設定
• Amazon ECS Sidecar として実行 AWS X-Ray デーモン

AWS SDK AWS CLI
AWS X-Ray SDK
AWS X-Ray API
収集されたセグメントデータから
トレースを作成

AWS SDK AWS CLI
AWS X-Ray SDK
AWS X-Ray API
X-Ray SDK を使わずに直接 X-Ray API と
データのやり取りをすることも可能

AWS X-Ray API
• AWS X-Ray の全ての機能にアクセス可能
• トレースの追加・取得・更新
• グループの作成・取得・更新・削除
• サンプリングルールの作成・取得・更新・削除
• 利用方法
• HTTPS 経由
• AWS SDK 経由
• AWS Command Line Interface 経由
AWS X-Ray API

AWS SDK AWS CLI
AWS X-Ray SDK
AWS X-Ray API
トレースをコンソールで可視化
分析・デバッグを行う

AWS Lambda
• トレースの有効化は AWS Lambda 関数の設定から
• 多少のメモリ消費量の増加あり
• HTTP 呼び出し・注釈・メタデータの追加などには
AWS X-Ray SDK が必要

Amazon API Gateway
• ステージの設定から X-Ray トレースの有効化
• HTTP リクエストにトレースヘッダーを追加
• AWS X-Ray コンソールで定義したサンプリングルール

AWS Elastic Beanstalk
• ソフトウェアから AWS X-Ray を有効化
• アプリケーションに AWS X-Ray SDK を組み込む作業は必要

Amazon EC2
• X-Ray デーモンが実行可能な OS
• Amazon Linux
• Ubuntu
• Windows Server (2012 R2 以降)
• インスタンス起動時にユーザーデータのスクリプトを実行してデーモンを起動
#!/bin/bash
curl https://s3.dualstack.us-east-
2.amazonaws.com/aws-xray-assets.us-east-2/xray-
daemon/aws-xray-daemon-3.x.rpm -o /home/ec2-
user/xray.rpm
yum install -y /home/ec2-user/xray.rpm
Amazon Linux の例

• AWS X-Ray デーモンの Docker コンテナを Sidecar として設定
• ネットワークモードによってコンテナ周りのタスク定義の設定が異なる
• ブリッジ (デフォルト) リンクを作成し環境変数 AWS_XRAY_DAEMON_ADDRESS に向き
先を設定
• awsvpc 特に設定は必要ない
{
"name": "xray-daemon",
"image": "amazon/aws-xray-
daemon",
"cpu": 32,
"memoryReservation": 256,
"portMappings" : [
{
"hostPort": 0,
"containerPort": 2000,
"protocol": "udp"
}
],
}
AWS X-Ray API
AWS X-Ray
SDK
Amazon ECS タスク
AWS X-Ray
SDK
Amazon ECS

AWS App Mesh
• AWS App Mesh の Envoy プロキシに環境変数 ENABLE_ENVOY_XRAY_TRACING: ”1”に設定するこ
とで
AWS X-Ray デーモン (127.0.0.1:2000) にデータを転送
• AWS AppMeshが動作している環境に応じて AWS X-Ray デーモンの設定が必要
AWS X-Ray API
AWS X-Ray
SDK
AWS App Mesh Sidecar
AWS X-Ray
SDK
AWS App Mesh Sidecar
Amazon ECS の例

Amazon SQS, Amazon SNS
• Amazon SQS と Amazon SNS とも統合
• 統合を有効化する設定は必要ない
パッシブ計測別のサービスですでにサンプリングされているリクエストを計測 Amazon SQS, Amazon SNS
アクティブ計測受信リクエストをサンプリングして計測 Amazon API Gateway, AWS
Lambda
＊）Amazon API Gateway と AWS Lambda はパッシブ計測も可能
パッシブ計測
AWS Lambda
Amazon SQS
コンシューマー
Amazon SQS の例

AWS SAM, CDK
• AWS SAM, CDK から X-Ray の有効化が可能
Type:
AWS::Serverless::Function
Properties:
FunctionName: MyFunction
Handler: index.handler
Tracing: Active
...
const myFunction = new lambda.Function(this,
'myFunction', {
functionName: 'MyFunction',
handler: 'index.handler',
tracing: lambda.Tracing.ACTIVE,
...
});
AWS SAM CDK (Typescript)
AWS Lambda の例

AWS X-Ray SDK (Node.js)
• 受信リクエストのトレース ( express の例 )
const app = express();
const AWSXRay = require('aws-xray-sdk');
app.use(AWSXRay.express.openSegment('MyAp
p'));
app.get('/', function (req, res) {
res.render('index');
});
app.use(AWSXRay.express.closeSegment());
AWSXRay.captureHTTPsGlobal(require('http’));
AWSXRay.capturePromise(); // request-promise, axios
利用時
// http を利用する場合
const http = require('http’);
// request を利用する場合
const request = require('request’);
// axios を利用する場合
const axios = require('axios’);
• HTTPリクエストのトレース

AWS X-Ray SDK (Node.js)
• AWS サービス呼び出しのトレース • カスタムサブセグメントの生成
const AWS = AWSXRay.captureAWS(require('aws-
sdk'));
const s3 = new AWS.S3();
// s3 を利用した呼び出しはトレースされる
AWSXRay.captureFunc('SubSegment1', (subsegment) =>
{
console.log('hello!');
});
AWSXRay.captureAsyncFunc('SubSegment2',
(subsegment) => {
setTimeout(() => { subsegment.close() }, 1000);
});

Amazon CloudWatch ServiceLens
• Amazon CloudWatch と AWS X-Ray を統合
• トレース
• メトリクス
• ログ
• アラート
AWS X-Ray のデータを利用
メトリクスグラフ、アラート
Amazon CloudWatch Logs インサイト
トレースの一覧やフィルタリング機能
メトリクスの詳細やノードマップ

Amazon CloudWatch Synthetics
• Canaryを作成してエンドポイントを監視
• Canaryとは
• 特定のエンドポイントにアクセス
• 定期的なスケジュールで実行
• ロード時間データとUIのスクリーンショットを保存
• 閾値によってアラームを作成
Canary実行
• Amazon CloudWatch ServiceLens、AWS X-Ray と統合

料金 (2020/5/26 現在)
• 記録、取得、スキャンされたトレースの数に基づいて料金が発生
• 永続的な無料利用枠
• 毎月トレースの記録は 10 万回まで無料
• 毎月トレースの取得とスキャンは合わせて 100 万回まで無料
トレースの記録 100 万件あたり 5.00USD
トレースの取得 100 万件あたり 0.50USD
トレースのスキャン 100 万件あたり 0.50USD
* 無料利用枠を超えた分
* リージョンアジアパシフィック (東京)
https://aws.amazon.com/xray/pricing/

注意点
• サンプリングについて
• デフォルトではサンプリングされる
• 100% トレースする設定も可能だが、料金とパフォーマンスへの影響
を事前に確認する
• データの完全性は保証されない
• 監査やコンプライアンスのツールとして使用することはできない
• 直近 30 日間の追跡データが保存
• 過去 30 日間の追跡データに対してクエリを実行可能

まとめ
AWS X-Ray
有用なツール群
• サービスマップマイクロサービスアプリケーションにおいて把握が難しい
サービス間の依存関係をわかりやすく可視化
• トレースリスト詳細なトレースデータにアクセス可能
セグメントやサブセグメントの実行状況を可視化
• アナリティクスインタラクティブな操作によって素早い分析が可能
利用の容易さ
 AWS X-Ray SDK や AWS X-Ray デーモンによってアプリケーションに簡単に組み込める
 多くの AWS サービスと統合されていて簡単にセットアップ可能

Q&A
お答えできなかったご質問については
AWS Japan Blog 「https://aws.amazon.com/jp/blogs/news/」にて
後日掲載します。

AWS の日本語資料の場所「AWS 資料」で検索

で[検索]AWS イベント
毎週”W-A個別技術相談会”を実施中
• AWSのソリューションアーキテクト(SA)に
対策などを相談することも可能
• 申込みはイベント告知サイトから
(https://aws.amazon.com/jp/about-aws/events/)
AWS Well-Architected 個別技術相談会

© 2020, Amazon Web Services, Inc. or its Affiliates. All rights reserved.© 2020, Amazon Web Services, Inc. or its Affiliates. All rights reserved.
AWS 公式 Webinar
https://amzn.to/JPWebinar
過去資料
ご視聴ありがとうございました

20200526 AWS Black Belt Online Seminar AWS X-Ray

More Related Content

What's hot (20)

Similar to 20200526 AWS Black Belt Online Seminar AWS X-Ray (20)

More from Amazon Web Services Japan (20)

Recently uploaded (20)

20200526 AWS Black Belt Online Seminar AWS X-Ray