

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á.

# Usar o mapa de rastreamento do X-Ray
<a name="xray-console-servicemap"></a>

Visualize o mapa de rastreamento do X-Ray para identificar os serviços nos quais estão ocorrendo erros, conexões com alta latência ou rastreamentos de solicitações com erros.

**nota**  
 O CloudWatch agora inclui o [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html), que pode descobrir e monitorar serviços das suas aplicações, clientes, canários do Synthetics e dependências de serviços. Use o Application Signals para ver uma lista ou um mapa visual dos seus serviços, visualizar métricas de integridade com base nos seus objetivos de nível de serviço (SLOs) e fazer uma busca profunda para ver rastreamentos do X-Ray correlacionados para uma solução de problemas mais detalhada.   
O mapa de serviços do X-Ray e o mapa do CloudWatch ServiceLens foram combinados no mapa de rastreamento do X-Ray no console do Amazon CloudWatch. Abra o [console do CloudWatch](https://console.aws.amazon.com/cloudwatch/) e escolha **Mapa de rastreamento** em **Rastreamentos do X-Ray** no painel de navegação esquerdo. 

## Exibir o mapa de rastreamento
<a name="xray-console-servicemap-view"></a>

O mapa de rastreamento é uma representação visual dos dados de rastreamento gerados pelas aplicações. Ele mostra nós de serviço que atendem a solicitações, nós de cliente precedentes que representam as origens das solicitações e nós de serviço subsequentes que representam serviços da web e recursos usados por uma aplicação ao processar uma solicitação. 

O mapa de rastreamento exibe uma visão conectada dos rastreamentos em aplicações orientadas a eventos que usam o Amazon SQS e o Lambda. Para obter mais informações, consulte [Rastrear aplicações orientadas a eventos](xray-tracelinking.md). O mapa de rastreamento também é compatível com [rastreamento entre contas](xray-console-crossaccount.md), exibindo nós de várias contas em um único mapa. 

------
#### [ CloudWatch console ]

**Como visualizar o mapa de rastreamento no console do CloudWatch**

1. [Abra o console do CloudWatch](https://console.aws.amazon.com/cloudwatch/). Escolha **Mapa de rastreamento** na seção **Rastreamentos do X-Ray** no painel de navegação esquerdo.   
![\[Página do mapa de rastreamento do console do CloudWatch\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/console-servicemap-cw.png)

1. Escolha um nó de serviço para visualizar solicitações desse nó ou uma borda entre dois nós para visualizar solicitações que percorreram essa conexão.

1.  Informações adicionais são exibidas abaixo do mapa de rastreamento, incluindo guias para métricas, alertas e distribuição do tempo de resposta. Na guia **Métricas**, selecione um intervalo em cada gráfico para ver mais detalhes ou escolha as opções **Falhas** ou **Erros** para filtrar os rastreamentos. Na guia **Distribuição do tempo de resposta**, selecione um intervalo no gráfico para filtrar os rastreamentos por tempo de resposta.   
![\[Dashboard showing latency, requests, and faults metrics for an ElasticBeanstalk environment.\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/console-cw-servicemap-node-detail.png)

1. Para visualize os rastreamentos, escolha **Visualizar rastreamentos** ou, se tiver sido aplicado um filtro, selecione **Exibir rastreamentos filtrados**.

1.  Escolha **Visualizar logs** para ver os logs do CloudWatch associados ao nó selecionado. Nem todos os nós do mapa de rastreamento oferecem suporte à visualização de logs. Consulte [Solução de problemas de logs do CloudWatch](xray-troubleshooting.md#xray-troubleshooting-Nologs) para obter mais informações. 

O mapa de rastreamento indica problemas em cada nó por meio de cores:
+ **Vermelho** para falhas do servidor (erros da série 500)
+ **Amarelo** para erros de clientes (erros da série 400)
+ **Roxo** para erros de controle de utilização (429, muitas solicitações)

Se o mapa de rastreamento for grande, use os controles na tela ou o mouse para aumentar e diminuir o zoom e mover o mapa.

------
#### [ X-Ray console ]

**Para visualizar o mapa de serviço**

1. Abra o [console do X-Ray](https://console.aws.amazon.com/xray/home#). O mapa de serviço é exibido por padrão. Você também pode escolher **Mapa de serviço** no painel de navegação esquerdo.   
![\[Página do mapa de serviço do console do X-Ray\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/console-servicemap-xray.png)

1. Escolha um nó de serviço para visualizar solicitações desse nó ou uma borda entre dois nós para visualizar solicitações que percorreram essa conexão.

1. Use o [histograma](xray-console-histograms.md) de distribuição de resposta para filtrar rastreamentos por duração e selecione códigos de status cujos rastreamentos você deseja visualizar. Em seguida, escolha **Visualizar rastreamentos** para abrir a lista de rastreamentos com a expressão de filtro aplicada.  
![\[Response distribution graph showing latency peaks and service details for Scorekeep AWS ECS container.\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/console-servicemap-nodedetail-xray.png)

O mapa de serviço indica a integridade de cada nó atribuindo cores a ele com base no índice de chamadas bem-sucedidas em relação a erros e falhas:
+ **Verde** para chamadas bem-sucedidas
+ **Vermelho** para falhas do servidor (erros da série 500)
+ **Amarelo** para erros de clientes (erros da série 400)
+ **Roxo** para erros de controle de utilização (429, muitas solicitações)

Se o mapa de serviço for grande, use os controles na tela ou o mouse para ampliar e reduzir e mover o mapa.

------

**nota**  
O mapa de rastreamento do X-Ray pode exibir até dez mil nós. Em situações raras em que o número total de nós de serviço excede esse limite, você pode receber um erro e não conseguir exibir um mapa de rastreamento completo no console. 

## Filtrar o mapa de rastreamento por grupo
<a name="xray-console-servicemap-groups"></a>

Ao usar uma [expressão de filtro](xray-console-filters.md), é possível definir critérios para incluir rastreamentos em um grupo. Use as etapas a seguir para exibir esse grupo específico no mapa de rastreamento.

------
#### [ CloudWatch console ]

Escolha um nome de grupo no filtro de grupos no canto superior esquerdo do mapa de rastreamento.

![\[Search bar for filtering by X-Ray group, with "TestGroup" displayed as an option.\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/console-servicemap-groups-cw.png)


------
#### [ X-Ray console ]

Escolha um nome de grupo no menu suspenso à esquerda da barra de pesquisa.

![\[Drop-down menu showing Default, TestGroup, Create group, and Learn more options.\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/group-select-console.png)


------

O mapa de serviço agora será filtrado para exibir rastreamentos que correspondam à expressão de filtro do grupo selecionado. 

## Legenda e opções do mapa de rastreamento
<a name="xray-console-servicemap-options"></a>

O mapa de rastreamento inclui uma legenda e várias opções para personalizar a exibição do mapa.

------
#### [ CloudWatch console ]

Escolha o menu suspenso **Legenda e opções** no canto superior direito do mapa. Escolha o que é exibido nos nós, como:
+  **Métricas**: exibem o tempo médio de resposta e o número de rastreamentos enviados por minuto durante o intervalo de tempo escolhido. 
+  **Nós**: exibem o ícone do serviço em cada nó. 

 Escolha configurações adicionais do mapa no painel **Preferências**, que pode ser acessado por meio do ícone de engrenagem no canto superior direito do mapa. Essas configurações exigem a seleção da métrica a ser usada para determinar o tamanho de cada nó e dos canários que devem ser exibidos no mapa. 

------
#### [ X-Ray console ]

Exiba a legenda do mapa de serviço escolhendo o link **Legenda do mapa** no canto superior direito do mapa. As opções do mapa de serviço podem ser escolhidas no canto inferior direito do mapa de rastreamento, como:
+  **Ícones de serviço**: alternam o que é exibido em cada nó, exibindo o ícone do serviço ou o tempo médio de resposta e o número de rastreamentos enviados por minuto durante o intervalo de tempo escolhido. 
+  **Dimensionamento de nó: Nenhum** define todos os nós com o mesmo tamanho. 
+  **Dimensionamento de nó: Integridade** dimensiona os nós pelo número de solicitações afetadas, incluindo erros, falhas ou solicitações com controle de utilização. 
+  **Dimensionamento de nó: Tráfego** dimensiona os nós pelo número total de solicitações. 

------