# Canary と X-Ray のトレース
<a name="CloudWatch_Synthetics_Canaries_tracing"></a>

` syn-nodejs-2.0` 以降のランタイムを使用する Canary でアクティブな AWS X-Ray トレースを有効にすることもできます。トレースが有効になっている場合、ブラウザ、AWS SDK、または HTTP または HTTPS モジュールを使用するCanary によって行われたすべての呼び出しに対してトレースが送信されます。トレースを有効にした canary は、[X-Ray トレースマップ](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-servicemap.html)に加え、アプリケーションで有効にした [Application Signals](CloudWatch-Application-Monitoring-Sections.md) にも表示されます。

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

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

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

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

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

------
#### [ JSON ]

****  

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

------

Canary によってトレースを生成すると、料金が発生します。X-Ray 料金の詳細については、[AWS X-Ray の料金](https://aws.amazon.com/xray/pricing/)を参照してください。