# 金丝雀和 X-Ray 跟踪
<a name="CloudWatch_Synthetics_Canaries_tracing"></a>

您可以选择对使用 ` syn-nodejs-2.0` 或更高版本运行时的金丝雀启用活动 AWS X-Ray 跟踪。启用跟踪后，将针对由使用浏览器、AWS SDK 或 HTTP 或 HTTPS 模块的金丝雀发出的所有调用发送 X-Ray 跟踪。启用了跟踪功能的 Canary 会显示在 [X-Ray 跟踪地图](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-servicemap.html)上，在您为应用程序启用此功能后显示在 [Application Signals](CloudWatch-Application-Monitoring-Sections.md) 中。

**注意**  
亚太地区（雅加达）尚不支持在金丝雀上激活 X-Ray 追踪。  
使用 Firefox 浏览器的金丝雀不支持 X-Ray 跟踪。

当 Canary 出现在 X-Ray 跟踪地图上时，其会显示为新的客户端节点类型。您可以将鼠标悬停在某个金丝雀节点上以查看有关延迟、请求和故障的数据。您也可以选择该金丝雀节点以在页面底部查看更多数据。在页面的此区域，您可以选择 **View in Synthetics（在 Synthetics 中查看）**以跳转到 CloudWatch Synthetics 控制台，了解有关金丝雀的更多详细信息，或选择 **View Traces（查看跟踪）**来查看有关此金丝雀运行的跟踪的更多详细信息。

启用了跟踪的金丝雀的详细信息页面上还有一个 **Tracing（跟踪）**选项卡，其中包含有关金丝雀运行的跟踪和分段的详细信息。

启用跟踪会将金丝雀的运行时增加 2.5% 至 7%。

启用了跟踪的金丝雀必须使用具有以下权限的角色。如果您在创建金丝雀时使用控制台创建角色，则会为其授予这些权限。

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

****  

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

------

金丝雀产生的跟踪会产生费用。有关 X-Ray 定价的更多信息，请参阅 [AWS X-Ray 定价](https://aws.amazon.com/xray/pricing/)。