

# Canaries e rastreamento do X-Ray
<a name="CloudWatch_Synthetics_Canaries_tracing"></a>

Você pode habilitar o rastreamento ativo AWS X-Ray somente para canários que usam o runtime ` syn-nodejs-2.0` ou posteriores. Com o rastreamento habilitado, os rastreamentos são enviados a todas as chamadas realizadas pelo canário que usam o navegador, o AWS SDK ou módulos HTTP ou HTTPS. Os canários com o rastreamento habilitado aparecem no [mapa de rastreamento do X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-servicemap.html) e no [Application Signals](CloudWatch-Application-Monitoring-Sections.md) depois que você o habilita para a aplicação. 

**nota**  
A ativação do rastreamento do X-Ray em canaries ainda não tem suporte na região Ásia-Pacífico (Jacarta).  
O rastreamento do X-Ray não é compatível com canários do navegador Firefox.

Quando um canário aparece no mapa de rastreamento do X-Ray, ele aparece como um novo tipo de nó de cliente. Você pode passar o mouse sobre um nó do canário para ver dados sobre latência, solicitações e falhas. Também é possível escolher o nó do canário para ver mais dados na parte inferior da página. Nesta área da página, você pode escolher **View in Synthetics** (Ver no Synthetics) para acessar o console do CloudWatch Synthetics para obter mais detalhes sobre o canário, ou escolha **View Traces** (Visualizar os rastreamentos) para ver mais detalhes sobre os rastreamentos de execuções desse canário.

Um canário com rastreamento habilitado também tem uma guia **Tracing** (Rastreamento) em sua página de detalhes, com detalhes sobre rastreamentos e segmentos das execuções do canário.

Habilitar o rastreamento aumenta o runtime do canário em 2,5% a 7%.

Um canário com rastreamento habilitado deve usar uma função com as permissões a seguir. Se você usar o console para criar a função ao criar o canário, ela receberá essas permissões.

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

****  

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

------

Os rastreamentos gerados por canaries incorrem em cobranças. Para obter mais informações sobre o preço do X-Ray, consulte [Preço do AWS X-Ray](https://aws.amazon.com/xray/pricing/).