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.
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 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-code111122223333meshNamevirtualNodeName -
Gateway virtual — arn:aws:appmesh: ::mesh/ /VirtualGateway/
Region-code111122223333meshNamevirtualGatewayName
-
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,offPadrã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
, 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
--concurrencyao iniciar o Envoy. Isso não é definido por padrão. Essa opção está disponível na versãov1.24.0.0-prodou superior do Envoy.Para obter mais informações, consulte Opções da linha de comando
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.nota
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áfegoIPv4quanto o tráfegoIPv6. Por padrão, esse sinalizador é definido como falso e o Envoy só recebe o tráfegoIPv4. 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 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:
0Má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:
100Mínimo:
100Má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:
20Mínimo:
5Má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 >1024seuid! =0. Certifique-se de que a porta seja menor que65535.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.
ENABLE_ENVOY_XRAY_TRACING-
Ativa o rastreamento do X-Ray usando
127.0.0.1:2000como o endpoint padrão do daemon. Para habilitar, defina o valor como1. 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 entre0e1.00(100%). Esse valor é substituído seXRAY_SAMPLING_RULE_MANIFESTfor especificado. Essa variável é compatível com imagens do Envoy da versãov1.19.1.1-prode 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 no Guia do desenvolvedor do AWS X-Ray . Essa variável é compatível com imagens do Envoy da versão
v1.19.1.0-prode 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ãov1.23.1.0-prodou 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
ENABLE_ENVOY_DATADOG_TRACING-
Permite a coleta de rastreamento do Datadog usando
127.0.0.1:8126como endpoint padrão do agente Datadog. Para ativar, defina o valor como1(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ãov1.18.3.0-prode 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ásicos1.16.1.0-prod e posterior.
ENABLE_ENVOY_JAEGER_TRACING-
Ativa a coleta de traços do Jaeger usando
127.0.0.1:9411como endpoint padrão do Jaeger. Para ativar, defina o valor como1(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
JSONouPROTOem formato codificado. Por padrão, esse valor é definido comoPROTO. Essa variável é compatível com imagens do Envoy da versãov1.23.1.0-prodou 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
config.trace.v3.Tracingna documentação do Envoy. nota
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_resourcesno mesmo arquivo de configuração de rastreamento. Por exemplo, o Zipkin tem um campocollector_clusterpara 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.
ENABLE_ENVOY_DOG_STATSD-
Ativa o uso de estatísticas DogStats D
127.0.0.1:8125como endpoint padrão do daemon. Para habilitar, defina o valor como1. 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ão1.15.0ou 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:8125Se aENVOY_STATS_SINKS_CFG_FILEvariá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ãov1.19.1.0-prodou 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_ARNquando o Envoy está se referindo a si mesmo em métricas e rastreamentos. É possível substituir esse comportamento definindo a variável de ambienteAPPMESH_RESOURCE_CLUSTERcom seu próprio nome. Essa variável só pode ser usada com a versão1.15.0ou posterior da imagem do Envoy. APPMESH_METRIC_EXTENSION_VERSION-
Defina o valor como
1para 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. APPMESH_DUALSTACK_ENDPOINT-
Defina o valor como
1para 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ínioIPv4. 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
ENABLE_ENVOY_STATS_TAGS-
Permite o uso de tags definidas pelo App Mesh
appmesh.mesheappmesh.virtual_node. Para obter mais informações, consulte config.metrics.v3. TagSpecifierna 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
. nota
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
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 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
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.