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á.
# Solução de problemas de observabilidade do App Mesh
**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)
Este tópico detalha problemas comuns que você pode enfrentar com a observabilidade do App Mesh.
## Não consigo ver os AWS X-Ray rastros dos meus aplicativos
**Sintomas**
Seu aplicativo no App Mesh não está exibindo informações de rastreamento do X-Ray no console do X-Ray ou APIs.
**Resolução**
Para usar o X-Ray no App Mesh, é necessário configurar corretamente os componentes para permitir a comunicação entre a aplicação, os contêineres auxiliares e o serviço X-Ray. Siga as etapas a seguir para confirmar se o X-Ray foi configurado corretamente:
+ Certifique-se de que o protocolo do receptor do nó virtual do App Mesh não esteja definido como `TCP`.
+ Certifique-se de que o contêiner X-Ray implantado com sua aplicação exponha a porta UDP `2000` e seja executado como usuário `1337`. Para obter mais informações, consulte o [exemplo do Amazon ECS X-Ray](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/howto-ecs-basics/deploy/2-meshify.yaml#L374-L386) em GitHub.
+ Certifique-se de que o contêiner Envoy tenha o rastreamento ativado. Se estiver usando a [imagem do App Mesh Envoy](envoy.md), você pode ativar o X-Ray definindo a variável de `ENABLE_ENVOY_XRAY_TRACING` ambiente como um valor de `1` e a variável de `XRAY_DAEMON_PORT` ambiente como `2000`.
+ Se você instrumentou o X-Ray no código do seu aplicativo com um [idioma específico SDKs ](https://docs.aws.amazon.com/xray/index.html), certifique-se de que ele esteja configurado corretamente seguindo os guias do seu idioma.
+ Se todos os itens anteriores estiverem configurados corretamente, revise os logs do contêiner X-Ray em busca de erros e siga as orientações em [Solução de problemas AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-troubleshooting.html). Uma explicação mais detalhada da integração do X-Ray no App Mesh pode ser encontrada em [Integrando o X-Ray com o App Mesh](https://aws.amazon.com/blogs/compute/integrating-aws-x-ray-with-aws-app-mesh/).
Se o problema ainda não tiver sido resolvido, considere abrir um [GitHub problema](https://github.com/aws/aws-app-mesh-roadmap/issues/new?assignees=&labels=Bug&template=issue--bug-report.md&title=Bug%3A+describe+bug+here) ou entre em contato com o [AWS Support](https://aws.amazon.com/premiumsupport/).
## Não consigo ver as métricas do Envoy para meus aplicativos nas métricas da Amazon CloudWatch
**Sintomas**
Seu aplicativo no App Mesh não está emitindo métricas geradas pelo proxy Envoy para métricas. CloudWatch
**Resolução**
Ao usar CloudWatch métricas no App Mesh, você deve configurar corretamente vários componentes para permitir a comunicação entre o proxy do Envoy, o sidecar do CloudWatch agente e o serviço de métricas. CloudWatch Siga as etapas a seguir para confirmar se as CloudWatch métricas do proxy Envoy foram configuradas corretamente:
+ Verifique se você está usando a imagem do CloudWatch agente para o App Mesh. Para obter mais informações, consulte [ CloudWatchAgente do App Mesh](https://github.com/aws-samples/aws-app-mesh-cloudwatch-agent) ativado GitHub.
+ Certifique-se de ter configurado o CloudWatch agente para o App Mesh adequadamente seguindo as instruções de uso específicas da plataforma. Para obter mais informações, consulte [ CloudWatchAgente do App Mesh](https://github.com/aws-samples/aws-app-mesh-cloudwatch-agent#usage) ativado GitHub.
+ Se todos os itens anteriores estiverem configurados corretamente, revise os registros do contêiner do CloudWatch agente em busca de erros e siga as orientações fornecidas em [Solução de problemas do CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/troubleshooting-CloudWatch-Agent.html).
Se o problema ainda não tiver sido resolvido, considere abrir um [GitHub problema](https://github.com/aws/aws-app-mesh-roadmap/issues/new?assignees=&labels=Bug&template=issue--bug-report.md&title=Bug%3A+describe+bug+here) ou entre em contato com o [AWS Support](https://aws.amazon.com/premiumsupport/).
## Não é possível configurar regras de amostragem personalizadas para rastreamentos AWS X-Ray
**Sintomas**
Sua aplicação está usando o rastreamento X-Ray, mas não foi possível configurar regras de amostragem para seus rastreamentos.
**Resolução**
Como o App Mesh Envoy atualmente não oferece suporte à **configuração de amostragem do Dynamic X-Ray**, as seguintes soluções alternativas estão disponíveis.
Se sua versão do Envoy for `1.19.1` ou posterior, você tem as seguintes opções.
+ Para definir apenas a taxa de amostragem, use a variável de ambiente `XRAY_SAMPLING_RATE` no contêiner do Envoy. O valor deve ser especificado como um decimal entre `0` e `1.00` (100%). Para obter mais informações, consulte [AWS X-Ray variáveis](envoy-config.md#envoy-xray-config).
+ Para configurar as regras de amostragem personalizadas localizadas para o rastreador X-Ray, use a variável de ambiente `XRAY_SAMPLING_RULE_MANIFEST` para especificar um caminho de arquivo no sistema de arquivos do contêiner do Envoy. Para obter mais informações, consulte [Regras de amostragem](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-go-configuration.html#xray-sdk-go-configuration-sampling) no *Guia do desenvolvedor do AWS X-Ray *.
Se sua versão do Envoy for anterior a `1.19.1`, faça o seguinte.
+ Use a variável de ambiente `ENVOY_TRACING_CFG_FILE` para alterar sua taxa de amostragem. Para obter mais informações, consulte [Variáveis de configuração do Envoy](envoy-config.md). Especifique uma configuração de rastreamento personalizada e defina as regras locais de amostragem. Para obter mais informações, consulte [Envoy X-Ray config](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/trace/v3/xray.proto.html#config-trace-v3-xrayconfig).
+ Configuração de rastreamento personalizada para o exemplo da variável de ambiente `ENVOY_TRACING_CFG_FILE`:
```
tracing:
http:
name: envoy.tracers.xray
typedConfig:
"@type": type.googleapis.com/envoy.config.trace.v3.XRayConfig
segmentName: foo/bar
segmentFields:
origin: AWS::AppMesh::Proxy
aws:
app_mesh:
mesh_name: foo
virtual_node_name: bar
daemonEndpoint:
protocol: UDP
address: 127.0.0.1
portValue: 2000
samplingRuleManifest:
filename: /tmp/sampling-rules.json
```
+ Para obter detalhes sobre a configuração do manifesto da regra de amostragem na propriedade `samplingRuleManifest`, consulte [Configurando o X-Ray SDK para Go](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-go-configuration.html#xray-sdk-go-configuration-sampling).
Se o problema ainda não tiver sido resolvido, considere abrir um [GitHub problema](https://github.com/aws/aws-app-mesh-roadmap/issues/new?assignees=&labels=Bug&template=issue--bug-report.md&title=Bug%3A+describe+bug+here) ou entre em contato com o [AWS Support](https://aws.amazon.com/premiumsupport/).