

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 e práticas recomendadas
<a name="troubleshooting-best-practices"></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) 

Recomendamos seguir as práticas recomendadas deste tópico para solucionar problemas ao usar o App Mesh.

## Ativar a interface de administração do proxy Envoy
<a name="ts-bp-enable-proxy-admin-interface"></a>

O proxy Envoy vem com uma interface de administração que pode ser usada para descobrir configurações e estatísticas e realizar outras funções administrativas, como drenagem da conexão. Para obter mais informações, consulte [Interface de administração](https://www.envoyproxy.io/docs/envoy/latest/operations/admin), na documentação do Envoy.

Se você usar o [Imagem do Envoy](envoy.md) gerenciado, o endpoint de administração será habilitado por padrão na porta 9901. Os exemplos fornecidos em [Solução de problemas de configuração do App Mesh](troubleshooting-setup.md) exibem o exemplo de URL do endpoint de administração como `http://my-app.default.svc.cluster.local:9901/`. 

**nota**  
O endpoint da administração nunca deve ser exposto à internet pública. Além disso, recomendamos monitorar os logs do endpoint de administração, que são definidos pela variável de ambiente `ENVOY_ADMIN_ACCESS_LOG_FILE` para `/tmp/envoy_admin_access.log`, por padrão. 

## Habilite a integração do Envoy DogStats D para descarga métrica
<a name="ts-bp-enable-envoy-statsd-integration"></a>

O proxy Envoy pode ser configurado para descarregar estatísticas para o tráfego das camadas OSI 4 e 7 e para a integridade do processo interno. Embora este tópico mostre como usar essas estatísticas sem transferir as métricas para coletores como métricas CloudWatch e Prometheus., ter essas estatísticas em um local centralizado para todos os seus aplicativos pode ajudá-lo a diagnosticar problemas e confirmar o comportamento mais rapidamente. Para obter mais informações, consulte [Usando o Amazon CloudWatch Metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) e a documentação do [Prometheus](https://prometheus.io/docs/introduction/overview/). 

Você pode configurar as métricas de DogStats D definindo os parâmetros definidos em[DogStatsVariáveis D](envoy-config.md#envoy-dogstatsd-config). Para obter mais informações sobre DogStats D, consulte a documentação de [DogStatsD.](https://docs.datadoghq.com/developers/dogstatsd/?tab=hostagent) Você pode encontrar uma demonstração da transferência de métricas para AWS CloudWatch métricas no tutorial [básico do App Mesh com o Amazon ECS.](https://github.com/aws/aws-app-mesh-examples/tree/main/walkthroughs/howto-ecs-basics) GitHub

## Habilitar logs de acesso
<a name="ts-bp-enable-access-logs"></a>

Recomendamos ativar os logs de acesso em seu [Nós virtuais](virtual_nodes.md) e [Gateways virtuais](virtual_gateways.md) para descobrir detalhes sobre o tráfego que transita entre suas aplicações. Para obter mais informações, consulte [Logs de acesso](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/observability/access_logging) na documentação do Envoy. Os logs fornecem informações detalhadas sobre o comportamento do tráfego nas camadas OSI 4 e 7. Ao usar o formato padrão do Envoy, você pode analisar os registros de acesso com CloudWatch o Logs [Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) usando a seguinte declaração de análise.

```
parse @message "[*] \"* * *\" * * * * * * * * * * *" as StartTime, Method, Path, Protocol, ResponseCode, ResponseFlags, BytesReceived, BytesSent, DurationMillis, UpstreamServiceTimeMillis, ForwardedFor, UserAgent, RequestId, Authority, UpstreamHost
```

## Ativar o registro em log de depuração do Envoy em ambientes de pré-produção
<a name="ts-bp-enable-envoy-debug-logging"></a>

Recomendamos definir o nível de log do proxy Envoy como `debug` em um ambiente de pré-produção. Os logs de depuração podem ajudar a identificar problemas antes de promover a definição associada ao App Mesh para seu ambiente de produção. 

Se estiver usando a [imagem do Envoy](envoy.md), poderá definir o nível do log para `debug` por meio da variável de ambiente `ENVOY_LOG_LEVEL`. 

**nota**  
Não é recomendado usar esse nível `debug` em ambientes de produção. [Definir o nível para `debug` aumentar o registro e pode afetar o desempenho e o custo geral dos registros transferidos para soluções como CloudWatch o Logs.](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html) 

Ao usar o formato padrão do Envoy, você pode analisar os registros do processo com CloudWatch o Logs [Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) usando a seguinte declaração de análise: 

```
parse @message "[*][*][*][*] [*] *" as Time, Thread, Level, Name, Source, Message
```

## Monitore a conectividade do Envoy Proxy com o ambiente de gerenciamento App Mesh
<a name="ts-bp-monitor-envoy-proxy-connectivity-state"></a>

É recomendável monitorar as métricas do Envoy `control_plane.connected_state` para garantir que o proxy do Envoy se comunique com o ambiente de gerenciamento do App Mesh para buscar os recursos de configuração dinâmica. Para obter mais informações, consulte [Servidor de gerenciamento](https://www.envoyproxy.io/docs/envoy/latest/configuration/overview/mgmt_server.html).