

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Integração ao CloudWatch para o X-Ray
<a name="xray-services-cloudwatch"></a>

AWS X-RayO se integra ao [CloudWatch Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html), CloudWatch RUM e CloudWatch Synthetics para facilitar o monitoramento da integridade das aplicações. Habilite seu aplicativo para o Application Signals para monitorar e solucionar problemas da integridade operacional dos seus serviços, páginas de clientes, canários do Synthetics e dependências de serviços.

O ServiceLens fornece uma visão completa de seus serviços correlacionando métricas, logs e rastreamentos, para ajudá-lo a identificar rapidamente gargalos de desempenho e identificar usuários atingidos.

Com o CloudWatch RUM, você pode realizar o monitoramento real do usuário para coletar e visualizar dados do lado do cliente sobre a performance da aplicação web com base em sessões reais do usuário praticamente em tempo real. Com o AWS X-Ray e o CloudWatch RUM, você pode analisar e depurar o caminho da solicitação a partir dos usuários finais da aplicação até os serviços subsequentes gerenciados pela AWS. Isso ajuda a identificar tendências e erros de latência que afetam os usuários finais. 

**Topics**
+ [CloudWatch RUM e AWS X-Ray](xray-services-RUM.md)
+ [Depurando canários CloudWatch sintéticos usando X-Ray](xray-services-cloudwatch-synthetics.md)

# CloudWatch RUM e AWS X-Ray
<a name="xray-services-RUM"></a>

Com o Amazon CloudWatch RUM, você pode realizar o monitoramento real do usuário para coletar e visualizar dados do lado do cliente sobre a performance da aplicação web com base em sessões reais do usuário praticamente em tempo real. Com o AWS X-Ray e o CloudWatch RUM, você pode analisar e depurar o caminho da solicitação a partir dos usuários finais da aplicação até os serviços subsequentes gerenciados pela AWS. Isso ajuda a identificar tendências e erros de latência que afetam os usuários finais. 

Depois que você ativa o rastreamento do X-Ray das sessões do usuário, o CloudWatch RUM adiciona um cabeçalho de rastreamento do X-Ray às solicitações HTTP permitidas e registra um segmento do X-Ray para solicitações HTTP permitidas. Você pode visualizar rastreamentos e segmentos dessas sessões de usuário no console do X-Ray e do CloudWatch, incluindo o mapa de serviço do X-Ray. 

**nota**  
O CloudWatch RUM não se integra a regras de amostragem do X-Ray. Em vez disso, escolha uma porcentagem de amostragem ao configurar a aplicação para usar o CloudWatch RUM. Os rastreamentos enviados do CloudWatch RUM podem incorrer em custos adicionais. Para obter mais informações, consulte [Preços do AWS X-Ray](https://aws.amazon.com/xray/pricing/). 

Por padrão, os rastreamentos do lado do cliente enviados do CloudWatch RUM não são conectados a rastreamentos do lado do servidor. Para conectar rastreamentos do lado do cliente com rastreamentos do lado do servidor, configure o cliente da web do CloudWatch RUM para adicionar um cabeçalho de rastreamento do X-Ray a essas solicitações HTTP. 

**Atenção**  
Configurar o cliente da web do CloudWatch RUM para adicionar um cabeçalho de rastreamento do X-Ray a solicitações HTTP pode fazer com que o compartilhamento de recursos de origem cruzada (CORS) falhe. Para evitar isso, adicione o cabeçalho HTTP `X-Amzn-Trace-Id` à lista de cabeçalhos permitidos na configuração do CORS do seu serviço subsequente. Se você estiver usando o API Gateway como serviço subsequente, consulte [Habilitar o CORS para um recurso da API REST](https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-cors.html). É altamente recomendável que você teste sua aplicação antes de adicionar um cabeçalho de rastreamento do X-Ray do lado do cliente em um ambiente de produção. Para obter mais informações, consulte a [ Documentação do cliente da Web do CloudWatch RUM](https://github.com/aws-observability/aws-rum-web/blob/main/docs/cdn_installation.md#http).

Para obter mais informações sobre o monitoramento real de usuários no CloudWatch, consulte [Usar o CloudWatch RUM](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-RUM.html). Para configurar a aplicação para usar o CloudWatch RUM, incluindo o rastreamento de sessões do usuário com o X-Ray, consulte [Configurar uma aplicação para usar o CloudWatch RUM](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-RUM-get-started.html). 

# Depurando canários CloudWatch sintéticos usando X-Ray
<a name="xray-services-cloudwatch-synthetics"></a>

CloudWatch O Synthetics é um serviço totalmente gerenciado que permite monitorar seus endpoints APIs usando canários com script que funcionam 24 horas por dia, uma vez por minuto. 

Você pode personalizar scripts canários para verificar se há alterações em: 
+ Disponibilidade
+ Latência
+ Transações
+ Links quebrados ou inoperantes
+ Step-by-step conclusões de tarefas
+ Erros de carregamento de página
+ Carregar latências para ativos de interface do usuário
+ Fluxos complexos do assistente
+ Fluxos de checkout em seu aplicativo

Os canários seguem as mesmas rotas e executam as mesmas ações e comportamentos que seus clientes, e verificam a experiência do cliente continuamente.

Para saber mais sobre como configurar testes do Synthetics, consulte [Using Synthetics to Create and Manage Canaries](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html).

![\[Exemplo de nó canário no mapa de rastreamento do x-ray.\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/synthetics-show-canary-active.png)


Os exemplos a seguir mostram casos de uso em comum para problemas de depuração que seus canários Synthetics levantam. Cada exemplo demonstra uma estratégia chave para depuração usando o mapa de serviço ou o console do X-Ray Analytics.

Para obter mais informações sobre como ler e interagir com o mapa de serviço, consulte [Exibição do mapa de serviços](https://docs.aws.amazon.com/xray/latest/devguide/xray-console.html#xray-console-servicemap). 

Para obter mais informações sobre como ler e interagir com o console do X-Ray Analytics, consulte [Interagindo com o console do AWS X-Ray Analytics](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-analytics.html). 

**Topics**
+ [Exibir canários com relatórios de erros aumentados no mapa de serviços](#xray-services-cloudwatch-synthetics-workflows-which-canary)
+ [Usar mapas de rastreamento em rastreamentos individuais para exibir cada solicitação detalhadamente](#xray-services-cloudwatch-synthetics-workflows-trace-map)
+ [Determinar a causa raiz de falhas contínuas nos serviços upstream e downstream](#xray-services-cloudwatch-synthetics-workflows-root-cause)
+ [Identificar gargalos e tendências de desempenho](#xray-services-cloudwatch-synthetics-workflows-bottlenecks)
+ [Comparar taxas de latência e erro ou falha antes e depois das alterações](#xray-services-cloudwatch-synthetics-workflows-latency)
+ [Determine a cobertura canária necessária para todos APIs e URLs](#xray-services-cloudwatch-synthetics-workflows-impact)
+ [Usar grupos para se concentrar em testes do Synthetics](#xray-services-cloudwatch-synthetics-groups)

## Exibir canários com relatórios de erros aumentados no mapa de serviços
<a name="xray-services-cloudwatch-synthetics-workflows-which-canary"></a>

 Para ver quais canários têm aumento de erros, falhas, taxas de controle de utilização ou tempos de resposta lentos dentro do mapa de serviço do X-Ray, é possível realçar nós de cliente do canário do Synthetics usando o [filtro](xray-console-filters.md) `Client::Synthetic`. Clicar em um nó exibe a distribuição do tempo de resposta de toda a solicitação. Clicar em uma borda entre dois nós mostra detalhes sobre as solicitações que percorreram aquela conexão. Você também pode visualizar nós inferidos “remotos” para serviços subsequentes relacionados no mapa de serviço. 

Quando você clica no nó Synthetics, há um botão **Visualizar em Synthetics** no painel lateral que redireciona você para o console do Synthetics, onde você pode verificar os detalhes do canário.

![\[Exemplo de nó de canário no mapa de serviço do X-Ray com detalhes de serviço.\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/synthetics-canary-servicedetail.png)


## Usar mapas de rastreamento em rastreamentos individuais para exibir cada solicitação detalhadamente
<a name="xray-services-cloudwatch-synthetics-workflows-trace-map"></a>

Para determinar qual serviço resulta na maior latência ou está causando um erro, chame o mapa de rastreamento selecionando o rastreamento no mapa de serviço. Os mapas individuais de detalhes de rastreamento exibem o end-to-end caminho de uma única solicitação. Use isso para entender os serviços invocados e visualizar os serviços upstream e downstream.

![\[Exemplo de nó canário no mapa de rastreamento do x-ray.\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/synthetics-canary-tracemap.png)


## Determinar a causa raiz de falhas contínuas nos serviços upstream e downstream
<a name="xray-services-cloudwatch-synthetics-workflows-root-cause"></a>

Depois de receber um CloudWatch alarme de falhas em um canário Synthetics, use a modelagem estatística em dados de rastreamento no X-Ray para determinar a provável causa raiz do problema no console do X-Ray Analytics. No console do Analytics, a tabela **Causa raiz do tempo de resposta** mostra os caminhos de entidades registrados. O X-Ray determina qual caminho no rastreamento é a causa mais provável do tempo de resposta. O formato indica uma hierarquia de entidades encontradas, terminando em uma causa raiz do tempo de resposta. 

O exemplo a seguir mostra que o teste do Synthetics para a API “XXX” em execução no API Gateway está falhando devido a uma exceção de capacidade de throughput da tabela do Amazon DynamoDB.

![\[Exemplo de nó canário no mapa de rastreamento do x-ray.\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/synthetics-canary-active-select.png)


![\[Exemplo de causa raiz do nó canário.\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/synthetics-canary-rootcause.png)


![\[Exemplo de filtro de anotação indicando o nó canário.\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/synthetics-canary-showannot.png)


## Identificar gargalos e tendências de desempenho
<a name="xray-services-cloudwatch-synthetics-workflows-bottlenecks"></a>

Você pode visualizar tendências no desempenho de seu endpoint ao longo do tempo usando o tráfego contínuo de seus canários Synthetic para preencher um mapa de rastreamento durante um período de tempo. 

![\[Exemplo de filtro de anotação indicando o nó canário.\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/synthetics-canary-distribution.png)


## Comparar taxas de latência e erro ou falha antes e depois das alterações
<a name="xray-services-cloudwatch-synthetics-workflows-latency"></a>

Identifique a hora em que ocorreu uma alteração para correlacionar essa alteração com um aumento de problemas capturados por seus canários. Use o console do X-Ray Analytics para definir os intervalos de tempo anteriores e posteriores como diferentes conjuntos de rastreamento, criando uma diferenciação visual na distribuição do tempo de resposta.

![\[Exemplo de filtro de anotação indicando o nó canário.\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/synthetics-canary-compare.png)


## Determine a cobertura canária necessária para todos APIs e URLs
<a name="xray-services-cloudwatch-synthetics-workflows-impact"></a>

 Use o X-Ray Analytics para comparar a experiência de canários com os usuários. A interface do usuário abaixo mostra uma linha de tendência azul para canários e uma linha verde para os usuários. Você também pode identificar que dois dos três URLs não têm testes de canário.

![\[Exemplo de filtro de anotação indicando o nó canário.\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/synthetics-canary-vs-customer.png)


## Usar grupos para se concentrar em testes do Synthetics
<a name="xray-services-cloudwatch-synthetics-groups"></a>

 Você pode criar um grupo do X-Ray usando uma expressão de filtro para se concentrar em determinado conjunto de fluxos de trabalho, como testes do Synthetics para a aplicação “www” em execução no AWS Elastic Beanstalk. Use [palavras-chave complexas](xray-console-filters.md#console-filters-complex) `service()` e `edge()` para filtrar serviços e bordas.

**Example Expressão do filtro de grupo**  

```
"edge(id(name: "www", type: "client::Synthetics"), id(name: "www", type: "AWS::ElasticBeanstalk::Environment"))" 
```

![\[Exemplo de nós para o Elastic Beanstalk www.\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/synthetics-canary-active-www.png)
