サンプリングルールの設定

• API Gateway Entrypoint — API Gateway は、サンプリングとアクティブトレースをサポートします。API ステージでアクティブトレースを有効にする方法については、「の Amazon API Gateway アクティブトレースのサポート AWS X-Ray」を参照してください。

• AWS AppSync - サンプリングとアクティブトレース AWS AppSync をサポートします。リクエストで AWS AppSync アクティブトレースを有効にするには、AWS 「X-Ray によるトレース」を参照してください。

• コンピューティングプラットフォームで X-Ray SDK を計測する – Amazon EC2、Amazon ECS、または などのコンピューティングプラットフォームを使用する場合 AWS Elastic Beanstalk、アプリケーションが最新の X-Ray SDK で計測されると、サンプリングがサポートされます。

サンプリングルールオプション

• [Rule name] (ルール名) (文字列) - ルールの一意の名前。

• [Priority] (優先度) (1～9999 の整数) - サンプリングルールの優先度。サービスでは、優先度の昇順でルールが評価され、一致する最初のルールを使用してサンプリングの決定が行われます。

• [Reservoir] (リザーバ) (負ではない整数) - 固定レートを適用する前に、1 秒あたりに計測する、一致するリクエストの固定数。リザーバはサービスで直接使用されませんが、ルールを一括して使用するすべてのサービスに適用されます。

• [レート] (0～100) - リザーバの上限に達した後に機器と一致するリクエストのパーセンテージ。コンソールでサンプリングルールを設定するときは、0 から 100 までのパーセンテージを選択します。JSON ドキュメントを使用してクライアント SDK でサンプリングルールを設定する場合は、0 から 1 までのパーセンテージ値を指定します。

• サービス名 (文字列) – トレースマップに表示される計測済みサービスの名前。

  • X-Ray SDK - レコーダーで設定したサービス名。

  • Amazon API Gateway - api-name/stage。

• サービスタイプ (文字列) — トレースマップに表示されるサービスタイプ。X-Ray SDK の場合、適切なプラグインを適用することで、サービスタイプを設定します。

  • AWS::ElasticBeanstalk::Environment – AWS Elastic Beanstalk 環境 (プラグイン）。

  • AWS::EC2::Instance — Amazon EC2 インスタンス (プラグイン)。

  • AWS::ECS::Container — Amazon ECS コンテナ (プラグイン)。

  • AWS::APIGateway::Stage - Amazon API Gateway ステージ。

  • AWS::AppSync::GraphQLAPI – AWS AppSync API リクエスト。

• [Host ] (ホスト) (文字列) - HTTP ホスト ヘッダーからの ホスト名。

• [HTTP method] (HTTP メソッド) (文字列) - HTTP リクエストのメソッド。

• [URL path] (URL パス) (文字列) - リクエストの URL パス。

  • X-Ray SDK - HTTP リクエスト URL のパス部分。

• リソース ARN (文字列) — サービスを実行している AWS リソースの ARN。

  • X-Ray SDK — サポートされていません。SDK では [リソース ARN] に * が設定されているルールのみを使用できます。

  • Amazon API Gateway — ステージ ARN。

• (オプション) [Attributes] (属性) (キーと値) - サンプリングデシジョンが行われたときに認識されるセグメント属性。

  • X-Ray SDK — サポートされていません。SDK は属性を指定するルールを無視します。

  • Amazon API Gateway — 元の HTTP リクエストからのヘッダー。

• Java: サンプリングルール

• Go: サンプリングルール

• Node.js: サンプリングルール

• Python: サンプリングルール

• Ruby: サンプリングルール

• .NET: サンプリングルール

サンプリング統計

• [Total matched rule] (ルールに一致した総数): 対象ルールに一致するリクエストの数。この数には、対象ルールに一致する可能性があるすべてのリクエストが含まれるわけではありません。優先度の高いルールに最初に一致したリクエストのみが含まれます。

• [Total sampled] (サンプリングされた総数): 記録されたリクエスト数。

• [Sampled with fixed rate] (サンプリングの固定レート): ルールの固定レートを適用してサンプリングされたリクエスト数。

• [Sampled with reservoir limit] (サンプリングのリザーバ制限):X-Rayによって割り当てられたクォータを使用してサンプリングされたリクエスト数。

• [Borrowed from reservoir] (リザーバから借用): リザーバからの借用によって、サンプリングされたリクエスト数。サービスで初めてリクエストがルールに一致するとき、X-Rayによりクォータがまだ割り当てられていません。ただし、リザーバが少なくとも 1 である場合、X-Rayがクォータを割り当てるまで、サービスは 1 秒あたり 1 つのトレースを借用します。