本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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 追蹤尚未獲得支援。  
Firefox 瀏覽器 Canary 不支援 X-Ray 追蹤。

當 Canary 出現在 X-Ray 追蹤地圖上時，它會顯示為新的用戶端節點類型。您可以將滑鼠暫留在 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/)。