

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

# Rastreamento
<a name="tracing"></a>

**Importante**  
Aviso de fim do suporte: em 30 de setembro de 2026, AWS o suporte para o. AWS App Mesh Depois de 30 de setembro de 2026, você não poderá mais acessar o AWS App Mesh console ou os AWS App Mesh recursos. Para obter mais informações, visite esta postagem no blog [Migrando do AWS App Mesh Amazon ECS Service Connect.](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect) 

**Importante**  
Para implementar totalmente o rastreamento, você precisará atualizar seu aplicativo.  
Para ver todos os dados disponíveis do serviço escolhido, você precisará instrumentar seu aplicativo usando as bibliotecas aplicáveis.

## Monitore o App Mesh com AWS X-Ray
<a name="x-ray"></a>

**Importante**  
Aviso de fim do suporte: em 30 de setembro de 2026, AWS o suporte para o. AWS App Mesh Depois de 30 de setembro de 2026, você não poderá mais acessar o AWS App Mesh console ou os AWS App Mesh recursos. Para obter mais informações, visite esta postagem no blog [Migrando do AWS App Mesh Amazon ECS Service Connect.](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect) 

AWS O X-Ray é um serviço que fornece ferramentas que permitem visualizar, filtrar e obter informações sobre os dados coletados das solicitações que seu aplicativo atende. Esses insights ajudam você a identificar problemas e oportunidades para otimizar seu aplicativo. Você pode ver informações detalhadas sobre solicitações e respostas e chamadas downstream que seu aplicativo faz para outros serviços da AWS .

O X-Ray se integra ao App Mesh para gerenciar seus microsserviços Envoy. Os dados de rastreamento do Envoy são enviados para o daemon X-Ray em execução no seu contêiner.

Implemente o X-Ray no código do seu aplicativo usando o guia do [SDK](https://docs.aws.amazon.com/xray/index.html) específico para sua linguagem.

### Ative o rastreamento do X-Ray por meio do App Mesh
<a name="enable-x-ray"></a>
+ 

**Dependendo do tipo de serviço:**
  + **ECS:** na definição do contêiner proxy Envoy, defina a variável de ambiente `ENABLE_ENVOY_XRAY_TRACING` como `1` e a variável de ambiente `XRAY_DAEMON_PORT` como `2000`.
  + **EKS:** na configuração do App Mesh Controller, inclua `--set tracing.enabled=true` e `--set tracing.provider=x-ray`.
+ Em seu contêiner X-Ray, exponha a porta `2000` e execute como usuário `1337`.

### Exemplos de X-Ray
<a name="x-ray-examples"></a>

Uma definição de contêiner Envoy para o Amazon ECS

```
      {
        "name": "envoy",
        "image": "840364872350.dkr.ecr.us-west-2.amazonaws.com/aws-appmesh-envoy:v1.15.1.0-prod",
        "essential": true,
        "environment": [
          {
            "name": "APPMESH_VIRTUAL_NODE_NAME",
            "value": "mesh/myMesh/virtualNode/myNode"
          },
          {
            "name": "ENABLE_ENVOY_XRAY_TRACING",
            "value": "1"
           }
        ],
        "healthCheck": {
          "command": [
            "CMD-SHELL",
            "curl -s http://localhost:9901/server_info | cut -d' ' -f3 | grep -q live"
            ],
           "startPeriod": 10,
           "interval": 5,
           "timeout": 2,
           "retries": 3
      }
```

Como atualizar o controlador App Mesh para Amazon EKS

```
helm upgrade -i appmesh-controller eks/appmesh-controller \
--namespace appmesh-system \
--set region=${AWS_REGION} \
--set serviceAccount.create=false \
--set serviceAccount.name=appmesh-controller \
--set tracing.enabled=true \
--set tracing.provider=x-ray
```

### Tutoriais para usar o X-Ray
<a name="x-ray-walkthrough"></a>
+ [Monitor com AWS X-Ray](https://github.com/aws/aws-app-mesh-examples/tree/main/examples/apps/colorapp#monitor-with-aws-x-ray)
+ [App Mesh com Amazon EKS—Observabilidade: X-Ray](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/eks/o11y-xray.md)
+ [Rastreamento distribuído com X-Ray](https://www.appmeshworkshop.com/x-ray/) [na oficina AWS App Mesh](https://www.appmeshworkshop.com/introduction/)

### Para saber mais sobre AWS X-Ray
<a name="x-ray-learn-more"></a>
+ [AWS Documentação do X-Ray](https://docs.aws.amazon.com/xray/index.html)

### Solução de problemas do AWS X-Ray com o App Mesh
<a name="x-ray-troubleshooting"></a>
+ [Não consigo ver os traços de AWS X-Ray dos meus aplicativos.](https://docs.aws.amazon.com/app-mesh/latest/userguide/troubleshoot-observability.html)

## Jaeger para o App Mesh com Amazon EKS
<a name="jaeger"></a>

O Jaeger é um sistema de rastreamento distribuído de código aberto de ponta a ponta. Ele pode ser usado para criar perfis de redes e para monitoramento. A Jaeger pode ajudar a solucionar problemas de aplicações nativas de nuvem complexas.

Para implementar o Jaeger no código do seu aplicativo, você pode encontrar o guia específico para sua linguagem nas [bibliotecas de rastreamento](https://www.jaegertracing.io/docs/1.21/client-libraries/) da documentação do Jaeger.

### Como instalar o Jaeger usando o Helm
<a name="installing-jaeger"></a>

1. Adicione o repositório do EKS ao Helm:

   ```
   helm repo add eks https://aws.github.io/eks-charts
   ```

1. Instale o App Mesh Jaeger

   ```
   helm upgrade -i appmesh-jaeger eks/appmesh-jaeger \
   --namespace appmesh-system
   ```

### Exemplo de Jaeger
<a name="jaeger-sample"></a>

Veja a seguir um exemplo de criação de uma `PersistentVolumeClaim` para armazenamento persistente do Jaeger.

```
helm upgrade -i appmesh-controller eks/appmesh-controller \
--namespace appmesh-system \
--set tracing.enabled=true \
--set tracing.provider=jaeger \
--set tracing.address=appmesh-jaeger.appmesh-system \
--set tracing.port=9411
```

### Passo a passo para usar o Jaeger
<a name="jaeger-walkthrough"></a>
+ [App Mesh com EKS—Observabilidade: Jaeger](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/eks/o11y-jaeger.md)

### Para saber mais a respeito da Jaeger
<a name="jaeger-eks"></a>
+ [Documentação do Jaeger](https://www.jaegertracing.io/)

## Datadog para rastreamento
<a name="datadog-tracing"></a>

O Datadog pode ser usado para rastreamento e métricas. Para mais informações e instruções de instalação, encontre o guia específico para o idioma do seu aplicativo na [documentação do Datadog](https://docs.datadoghq.com/tracing/setup_overview/).