Canary と X-Ray のトレース

syn-nodejs-2.0 以降のランタイムを使用する Canary でアクティブな AWS X-Ray トレースを有効にすることもできます。トレースが有効になっている場合、ブラウザ、AWS SDK、または HTTP または HTTPS モジュールを使用するCanary によって行われたすべての呼び出しに対してトレースが送信されます。トレースを有効にした canary は、X-Ray トレースマップに加え、アプリケーションで有効にした Application Signals にも表示されます。

注記

canary でのX-Ray 追跡のアクティブ化は、アジアパシフィック（ジャカルタ）ではまだサポートされていません。

X-Ray トレースマップでは、canary は新規クライアントノードタイプとして表示されます。Canary ノードにカーソルを合わせると、レイテンシー、リクエスト、および障害に関するデータを表示できます。また、Canary ノードを選択して、ページの下部にさらに多くのデータを表示することもできます。ページのこの領域から、[View in Synthetics (Synthetics で表示)] を選択して CloudWatch Synthetics コンソールにジャンプし、Canary の詳細を表示するか、[View Traces (トレースの表示)] を選択してこの Canary の実行からのトレースの詳細を表示できます。

トレースが有効な Canary にも、その詳細ページに [Tracing (トレース)] タブがあり、Canary の実行からのトレースとセグメントの詳細が表示されます。

トレースを有効にすると、Canary 実行時間が 2.5%～7% 増加します。

トレースが有効になっている Canary は、以下のアクセス許可を持つロールを使用する必要があります。Canary を作成するときにコンソールを使用してロールを作成する場合、これらのアクセス許可が与えられます。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Sid230934",
            "Effect": "Allow",
            "Action": [
                "xray:PutTraceSegments"
            ],
            "Resource": "*"
        }
    ]
}

Canary によってトレースを生成すると、料金が発生します。X-Ray 料金の詳細については、AWS X-Ray の料金を参照してください。