

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

# Agente do Envoy
<a name="appnet-agent"></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) 

O Agente é um gerenciador de processos dentro da imagem do Envoy que é fornecida para o App Mesh. O Agente garante que o Envoy continue funcionando, permaneça íntegro e reduza o tempo de inatividade. Ele filtra as estatísticas do Envoy e os dados auxiliares para fornecer uma visão resumida da operação do proxy do Envoy no App Mesh. Isso pode ajudá-lo a solucionar erros relacionados com mais rapidez.

Você pode usar o Agente para configurar o número de vezes que deseja reiniciar o proxy Envoy caso o proxy fique inoperante. Se ocorrer uma falha, o Agente registrará o status de saída conclusivo quando o Envoy sair. Você pode usar isso ao solucionar a falha. O Agente também facilita a drenagem da conexão do Envoy, o que ajuda a tornar seus aplicativos mais resilientes a falhas. 

Configure o Agente do Envoy usando estas variáveis:
+ `APPNET_ENVOY_RESTART_COUNT`: quando essa variável é definida com um valor diferente de zero, o Agente tenta reiniciar o processo de proxy do Envoy até o número que você definiu quando considera que o status do processo de proxy não está íntegro na sondagem. Isso ajuda a reduzir o tempo de inatividade, fornecendo uma reinicialização mais rápida se comparado com a substituição de uma tarefa ou pod pelo orquestrador de contêineres no caso de falhas na verificação de integridade do proxy. 
+ `PID_POLL_INTERVAL_MS`: ao configurar essa variável, o padrão é mantido como `100`. Quando definido com esse valor, você permite uma detecção e reinicialização mais rápidas do processo Envoy quando ele sai, em comparação com a substituição de tarefas ou pods por meio de verificações de integridade do orquestrador de contêineres.
+ `LISTENER_DRAIN_WAIT_TIME_S`: ao configurar essa variável, considere o tempo limite do orquestrador de contêineres definido para interromper a tarefa ou o pod. Por exemplo, se esse valor for maior que o tempo limite do orquestrador, o proxy Envoy só poderá ser drenado durante o período até que o orquestrador forçosamente interrompa a tarefa ou o pod.
+ `APPNET_AGENT_ADMIN_MODE`: quando essa variável é definida como `tcp` ou `uds`, o Agente fornece uma interface de gerenciamento local. Essa interface de gerenciamento serve como um endpoint seguro para interagir com o proxy Envoy e fornece o seguinte APIs para verificações de integridade, dados de telemetria e resume a condição operacional do proxy.
  + `GET /status`: consulta as estatísticas do Envoy e retorna as informações do servidor.
  + `POST /drain_listeners`: drena todos os receptores entrantes.
  + `POST /enableLogging?level=<desired_level>`: altere o nível de registro em log do Envoy em todos os loggers.
  + `GET /stats/prometheus`: exibe estatísticas do Envoy no formato Prometheus.
  + `GET /stats/prometheus?usedonly`: exibe apenas as estatísticas que o Envoy atualizou.

Para mais informações sobre as variáveis de configuração do Agente, consulte [Variáveis de configuração do Envoy](https://docs.aws.amazon.com/app-mesh/latest/userguide/envoy-config.html).

O novo AWS App Mesh agente está incluído nas imagens do Envoy otimizadas para App Mesh a partir da versão `1.21.0.0` e não requer alocação adicional de recursos nas tarefas ou pods do cliente.