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á.
# Variáveis de configuração do Envoy
**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)
Use as seguintes variáveis de ambiente para configurar os contêineres do Envoy para seus grupos de tarefas do nó virtual do App Mesh.
**nota**
O App Mesh Envoy 1.17 não é compatível com a API **v2 xDS** do Envoy. Se você estiver usando [variáveis de configuração do Envoy](https://docs.aws.amazon.com/app-mesh/latest/userguide/envoy-config.html) que aceitam arquivos de configuração do Envoy, elas devem ser atualizadas para a API ** v3 xDS** mais recente.
## Variáveis obrigatórias
A variável de ambiente a seguir é necessária para todos os contêineres do App Mesh Envoy. Essa variável só pode ser usada com a versão `1.15.0` ou posterior da imagem do Envoy. Se você estiver usando uma versão anterior da imagem, deverá definir a variável `APPMESH_VIRTUAL_NODE_NAME` em vez disso.
`APPMESH_RESOURCE_ARN`
Ao adicionar o contêiner do Envoy a um grupo de tarefas, defina essa variável de ambiente para o ARN do nó virtual ou do gateway virtual que o grupo de tarefas representa. A lista a seguir contém exemplos ARNs:
+ **Nó virtual** — arn:aws:appmesh: ::mesh/ /VirtualNode/ *Region-code* *111122223333* *meshName* *virtualNodeName*
+ **Gateway virtual** — arn:aws:appmesh: ::mesh/ /VirtualGateway/ *Region-code* *111122223333* *meshName* *virtualGatewayName*
## Variáveis opcionais
A variável de ambiente a seguir é opcional para todos os contêineres do App Mesh Envoy.
`ENVOY_LOG_LEVEL`
Especifica o nível de log do contêiner do Envoy.
Valores válidos: `trace`, `debug`, `info`, `warn`, `error`, `critical`, `off`
Padrão: `info`
`ENVOY_INITIAL_FETCH_TIMEOUT`
Especifica a quantidade de tempo que o Envoy espera pela primeira resposta de configuração do servidor de gerenciamento durante o processo de inicialização.
Para obter mais informações, consulte [Configuração de fontes](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/core/v3/config_source.proto#envoy-v3-api-field-config-core-v3-configsource-initial-fetch-timeout), na documentação do Envoy. Quando definido como `0`, não há tempo limite.
Padrão: `0`
`ENVOY_CONCURRENCY`
Define a opção de linha de comando `--concurrency` ao iniciar o Envoy. Isso não é definido por padrão. Essa opção está disponível na versão `v1.24.0.0-prod` ou superior do Envoy.
Para obter mais informações, consulte [Opções da linha de comando](https://www.envoyproxy.io/docs/envoy/latest/operations/cli#cmdoption-concurrency) na documentação do Envoy.
### Variáveis de administração
Usam essas variáveis de ambiente para configurar a interface administrativa do Envoy.
`ENVOY_ADMIN_ACCESS_PORT`
Especificam uma porta de administração personalizada para o Envoy receber. Padrão: `9901`.
A porta de administração do Envoy deve ser diferente de qualquer porta de ouvinte no gateway virtual ou no nó virtual.
`ENVOY_ADMIN_ACCESS_LOG_FILE`
Especificam um caminho personalizado no qual os logs de acesso do Envoy serão gravados. Padrão: `/tmp/envoy_admin_access.log`.
`ENVOY_ADMIN_ACCESS_ENABLE_IPV6`
Alterna a interface de administração do Envoy para aceitar tráfego `IPv6`, o que permite que essa interface aceite tanto o tráfego `IPv4` quanto o tráfego `IPv6`. Por padrão, esse sinalizador é definido como falso e o Envoy só recebe o tráfego `IPv4`. Essa variável só pode ser usada com a versão 1.22.0 ou posterior da imagem do Envoy.
### Variáveis de agente
Use essas variáveis de ambiente para configurar o AWS App Mesh Agent for Envoy. Para obter mais informações, consulte o [Agente para Envoy](https://docs.aws.amazon.com//app-mesh/latest/userguide/appnet-agent.html) no App Mesh.
`APPNET_ENVOY_RESTART_COUNT`
Especifica o número de vezes que o Agente reinicia o processo de proxy do Envoy em uma tarefa ou pod em execução, caso ele saia. O Agente também registra o status de saída toda vez que o Envoy sai para facilitar a solução de problemas. O valor padrão da variável é `0`. Quando o valor padrão é definido, o Agente não tenta reiniciar o processo.
Padrão: `0`
Máximo: `10`
`PID_POLL_INTERVAL_MS`
Especifica o intervalo em milissegundos no qual o estado do processo do proxy do Envoy é verificado pelo Agente. O valor padrão é `100`.
Padrão: `100`
Mínimo: `100`
Máximo: `1000`
`LISTENER_DRAIN_WAIT_TIME_S`
Especifica a quantidade de tempo em segundos que o proxy do Envoy espera que as conexões ativas sejam fechadas antes que o processo seja encerrado.
Padrão: `20`
Mínimo: `5`
Máximo: `110`
`APPNET_AGENT_ADMIN_MODE`
Inicia o servidor da interface de gerenciamento do Agente e o vincula a um endereço tcp ou a um soquete unix.
Valores válidos: `tcp`, `uds`
`APPNET_AGENT_HTTP_PORT`
Especifique uma porta a ser usada para vincular a interface de gerenciamento do Agente no modo `tcp`. Certifique-se de que o valor da porta seja > `1024` se `uid` \$1 = `0`. Certifique-se de que a porta seja menor que `65535`.
Padrão: `9902`
`APPNET_AGENT_ADMIN_UDS_PATH`
Especifique o caminho do soquete de domínio unix para a interface de gerenciamento do Agente no modo `uds`.
Padrão: `/var/run/ecs/appnet_admin.sock`
### Variáveis de rastreamento
É possível configurar um ou nenhum dos seguintes drivers de rastreamento.
#### AWS X-Ray variáveis
Use as seguintes variáveis de ambiente para configurar o App Mesh com AWS X-Ray. Para obter mais informações, consulte o [Guia do desenvolvedor do AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/).
`ENABLE_ENVOY_XRAY_TRACING`
Ativa o rastreamento do X-Ray usando `127.0.0.1:2000` como o endpoint padrão do daemon. Para habilitar, defina o valor como `1`. O valor padrão é `0`.
`XRAY_DAEMON_PORT`
Especifique um valor de porta para substituir a porta padrão do daemon X-Ray: `2000`.
`XRAY_SAMPLING_RATE`
Especifique uma taxa de amostragem para substituir a taxa de amostragem padrão do rastreador do X-Ray de `0.05` (5%). Especifique o valor como decimal entre `0` e `1.00` (100%). Esse valor é substituído se `XRAY_SAMPLING_RULE_MANIFEST` for especificado. Essa variável é compatível com imagens do Envoy da versão `v1.19.1.1-prod` e posterior.
`XRAY_SAMPLING_RULE_MANIFEST`
Especifique um caminho de arquivo no sistema de arquivos do contêiner Envoy para configurar as regras de amostragem personalizadas localizadas para o rastreador do X-Ray. 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 *. Essa variável é compatível com imagens do Envoy da versão `v1.19.1.0-prod` e posterior.
`XRAY_SEGMENT_NAME`
Especifique um nome de segmento para traços para substituir o nome padrão do segmento do X-Ray. Por padrão, esse valor é definido como `mesh/resourceName`. Essa variável é compatível com imagens do Envoy da versão `v1.23.1.0-prod` ou posterior.
#### Variáveis de rastreamento do Datadog
As variáveis de ambiente a seguir ajudam você a configurar o App Mesh com o rastreador do agente Datadog. Para obter mais informações, consulte [Agente de configuração](https://docs.datadoghq.com/tracing/send_traces/), na documentação do Datadog.
`ENABLE_ENVOY_DATADOG_TRACING`
Permite a coleta de rastreamento do Datadog usando `127.0.0.1:8126` como endpoint padrão do agente Datadog. Para ativar, defina o valor como `1` (o valor padrão é `0`).
`DATADOG_TRACER_PORT`
Especifique um valor de porta para substituir a porta padrão do Datadog: `8126`.
`DATADOG_TRACER_ADDRESS`
Especifique um endereço IP para substituir o endereço padrão do agente do Datadog: `127.0.0.1`.
`DD_SERVICE`
Especifique um nome de serviço para traços para substituir o nome padrão do serviço do Datadog: `envoy-meshName`/`virtualNodeName`. Essa variável é compatível com imagens do Envoy da versão `v1.18.3.0-prod` e posterior.
#### Variáveis de rastreamento de Jaeger
Use as seguintes variáveis de ambiente para configurar o App Mesh com rastreamento de Jaeger. Para obter mais informações, consulte [Conceitos básicos](https://www.jaegertracing.io/docs/1.21/getting-started/) na Documentação do Jaeger. Essas variáveis são compatíveis com imagens do Envoy da versão `1.16.1.0-prod` e posterior.
`ENABLE_ENVOY_JAEGER_TRACING`
Ativa a coleta de traços do Jaeger usando `127.0.0.1:9411` como endpoint padrão do Jaeger. Para ativar, defina o valor como `1` (o valor padrão é `0`).
`JAEGER_TRACER_PORT`
Especifique um valor de porta para substituir a porta padrão do Jaeger: `9411`.
`JAEGER_TRACER_ADDRESS`
Especifique um endereço IP para substituir o endereço padrão do agente do Jaeger: `127.0.0.1`.
`JAEGER_TRACER_VERSION`
Especifique se o coletor precisa de traços em `JSON` ou `PROTO` em formato codificado. Por padrão, esse valor é definido como `PROTO`. Essa variável é compatível com imagens do Envoy da versão `v1.23.1.0-prod` ou posterior.
#### Variável de rastreamento do Envoy
Defina a variável de ambiente a seguir para usar sua própria configuração de rastreamento.
`ENVOY_TRACING_CFG_FILE`
Especifique um caminho de arquivo no sistema de arquivos do contêiner Envoy. Para obter mais informações, consulte [https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/trace/v3/http_tracer.proto#envoy-v3-api-msg-config-trace-v3-tracing](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/trace/v3/http_tracer.proto#envoy-v3-api-msg-config-trace-v3-tracing) na documentação do Envoy.
Se a configuração de rastreamento exigir a especificação de um cluster de rastreamento, certifique-se de configurar a configuração do cluster associado abaixo `static_resources` no mesmo arquivo de configuração de rastreamento. Por exemplo, o Zipkin tem um campo [https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/trace/v3/zipkin.proto#config-trace-v3-zipkinconfig](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/trace/v3/zipkin.proto#config-trace-v3-zipkinconfig) para o nome do cluster que hospeda os coletores de rastreamento, e esse cluster precisa ser definido estaticamente.
### DogStatsVariáveis D
Use as seguintes variáveis de ambiente para configurar o App Mesh com DogStats D. Para obter mais informações, consulte a documentação [DogStatsD.](https://docs.datadoghq.com/developers/dogstatsd/)
`ENABLE_ENVOY_DOG_STATSD`
Ativa o uso de estatísticas DogStats D `127.0.0.1:8125` como endpoint padrão do daemon. Para habilitar, defina o valor como `1`.
`STATSD_PORT`
Especifique um valor de porta para substituir a porta padrão do daemon DogStats D.
`STATSD_ADDRESS`
Especifique um valor de endereço IP para substituir o endereço IP padrão do daemon DogStats D. Padrão: `127.0.0.1`. Essa variável só pode ser usada com a versão `1.15.0` ou posterior da imagem do Envoy.
`STATSD_SOCKET_PATH`
Especifique um soquete de domínio unix para o daemon DogStats D. Se essa variável não for especificada e DogStats D estiver habilitada, esse valor será padronizado para a porta de endereço IP do daemon DogStats D de. `127.0.0.1:8125` Se a `ENVOY_STATS_SINKS_CFG_FILE` variável for especificada contendo uma configuração de coletores de estatísticas, ela substituirá todas as DogStats variáveis D. Essa variável é compatível com imagens do Envoy da versão `v1.19.1.0-prod` ou posterior.
### Variáveis do App Mesh
As variáveis a seguir ajudam você a configurar o App Mesh.
`APPMESH_RESOURCE_CLUSTER`
Por padrão, o App Mesh usa o nome do recurso especificado em `APPMESH_RESOURCE_ARN` quando o Envoy está se referindo a si mesmo em métricas e rastreamentos. É possível substituir esse comportamento definindo a variável de ambiente `APPMESH_RESOURCE_CLUSTER` com seu próprio nome. Essa variável só pode ser usada com a versão `1.15.0` ou posterior da imagem do Envoy.
`APPMESH_METRIC_EXTENSION_VERSION`
Defina o valor como `1` para ativar a extensão de métricas do App Mesh. Para mais informações sobre o uso da extensão de métricas do App Mesh, consulte [Extensão de métricas para o App Mesh](metrics.md).
`APPMESH_DUALSTACK_ENDPOINT`
Defina o valor como `1` para se conectar ao endpoint do App Mesh Dual Stack. Quando esse sinalizador é definido, o Envoy usa nosso domínio com capacidade de pilha dupla. Por padrão, esse sinalizador é definido como falso e se conecta apenas ao nosso domínio `IPv4`. Essa variável só pode ser usada com a versão 1.22.0 ou posterior da imagem do Envoy.
### Variáveis de estatísticas do Envoy
Use as seguintes variáveis de ambiente para configurar o App Mesh com Envoy. Para obter mais informações, consulte a documentação [Estatísticas do Envoy](https://www.envoyproxy.io/docs/envoy/v1.6.0/api-v2/config/metrics/v2/stats.proto).
`ENABLE_ENVOY_STATS_TAGS`
Permite o uso de tags definidas pelo App Mesh `appmesh.mesh` e `appmesh.virtual_node`. Para obter mais informações, consulte [config.metrics.v3. TagSpecifier](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-tagspecifier)na documentação do Envoy. Para habilitar, defina o valor como `1`.
`ENVOY_STATS_CONFIG_FILE`
Especifique um caminho de arquivo no sistema de arquivos do contêiner Envoy para substituir o arquivo de configuração padrão das tags Stats pelo seu próprio. Para obter mais informações, consulte [config.metrics.v3. StatsConfig](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-statsconfig).
Definir uma configuração de estatísticas personalizada que inclua filtros de estatísticas pode levar o Envoy a entrar em um estado em que não será mais sincronizado adequadamente com o estado mundial do App Mesh. Isso é um [bug](https://github.com/envoyproxy/envoy/issues/9856) do Envoy. Nossa recomendação é não realizar nenhuma filtragem de estatísticas no Envoy. Se a filtragem for absolutamente necessária, listamos algumas soluções alternativas para esse [problema](https://github.com/aws/aws-app-mesh-roadmap/issues/283) em nosso roteiro.
`ENVOY_STATS_SINKS_CFG_FILE`
Especifique um caminho de arquivo no sistema de arquivos do contêiner Envoy para substituir a configuração padrão pela sua própria. Para obter mais informações, consulte [config.metrics.v3. StatsSink](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-statssink)na documentação do Envoy.
### Variáveis descontinuadas
As variáveis `APPMESH_VIRTUAL_NODE_NAME` e `APPMESH_RESOURCE_NAME` de ambiente não são mais compatíveis com a versão `1.15.0` ou posterior do Envoy. No entanto, elas ainda são compatíveis com malhas existentes. Em vez de usar essas variáveis com a versão Envoy `1.15.0` ou posterior, use `APPMESH_RESOURCE_ARN` para todos os endpoints do App Mesh.