Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Variables de configuración de Envoy
**importante**
Aviso de fin del soporte: el 30 de septiembre de 2026, AWS dejaremos de ofrecer soporte a. AWS App Mesh Después del 30 de septiembre de 2026, ya no podrás acceder a la AWS App Mesh consola ni a AWS App Mesh los recursos. Para obtener más información, visite esta entrada del blog [Migración desde AWS App Mesh a Amazon ECS Service Connect](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect).
Use las siguientes variables de entorno para configurar los contenedores de Envoy para sus grupos de tareas de nodos virtuales de App Mesh.
**nota**
App Mesh Envoy 1.17 no es compatible con la API **xDS v2** de Envoy. Si utiliza [variables de configuración de Envoy](https://docs.aws.amazon.com/app-mesh/latest/userguide/envoy-config.html) que aceptan archivos de configuración de Envoy, debe actualizarlas a la última versión** v3 xDS** de la API.
## Variables obligatorias
La siguiente variable de entorno es necesaria para todos los contenedores de App Mesh Envoy. Esta variable solo se puede usar con la versión `1.15.0` o posterior de la imagen de Envoy. Si utiliza una versión anterior de la imagen, debe configurar la variable `APPMESH_VIRTUAL_NODE_NAME` en su lugar.
`APPMESH_RESOURCE_ARN`
Al agregar el contenedor de Envoy a un grupo de tareas, establezca esta variable de entorno en el ARN del nodo virtual o la puerta de enlace virtual que representa el grupo de tareas. La siguiente lista contiene un ejemplo ARNs:
+ **Nodo virtual**: arn:aws:appmesh: ::mesh/ /VirtualNode/ *Region-code* *111122223333* *meshName* *virtualNodeName*
+ Puerta de **enlace virtual**: arn:aws:appmesh: *Region-code* ::mesh/ /VirtualGateway/ *111122223333* *meshName* *virtualGatewayName*
## Variables opcionales
La siguiente variable de entorno es opcional para los contenedores de App Mesh Envoy.
`ENVOY_LOG_LEVEL`
Especifica el nivel de registro del contenedor de Envoy.
Valores válidos: `trace`, `debug`, `info`, `warn`, `error`, `critical`, `off`
Valor predeterminado: `info`
`ENVOY_INITIAL_FETCH_TIMEOUT`
Especifica el tiempo que Envoy espera la primera respuesta de configuración del servidor de administración durante el proceso de inicialización.
Para obtener más información, consulte [Orígenes de configuración](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) en la documentación de Envoy. Si se establece en `0`, no hay tiempo de espera.
Valor predeterminado: `0`
`ENVOY_CONCURRENCY`
Establece la opción de línea de comandos `--concurrency` al iniciar Envoy. No se establece de forma predeterminada. Esta opción está disponible desde la versión `v1.24.0.0-prod` o superior de Envoy.
Para obtener más información, consulte [Opciones de línea de comandos](https://www.envoyproxy.io/docs/envoy/latest/operations/cli#cmdoption-concurrency) en la documentación de Envoy.
### Variables de administración
Utilice estas variables de entorno para configurar la interfaz administrativa de Envoy.
`ENVOY_ADMIN_ACCESS_PORT`
Especifique un puerto de administración personalizado en el que Envoy pueda escuchar. Predeterminado: `9901`.
El puerto de administración de Envoy debe ser diferente de cualquier puerto de escucha de la puerta de enlace virtual o el nodo virtual
`ENVOY_ADMIN_ACCESS_LOG_FILE`
Especifique una ruta personalizada en la que escribir los registros de acceso de Envoy. Predeterminado: `/tmp/envoy_admin_access.log`.
`ENVOY_ADMIN_ACCESS_ENABLE_IPV6`
Activa o desactiva la interfaz de administración de Envoy para que acepte tráfico `IPv6`, lo que permite que esta interfaz acepte tanto tráfico `IPv4` como `IPv6`. De forma predeterminada, este indicador está establecido en falso y Envoy solo escucha tráfico `IPv4`. Esta variable solo se puede usar con la versión 1.22.0 o posterior de la imagen de Envoy.
### Variables del agente
Utilice estas variables de entorno para configurar el AWS App Mesh agente para Envoy. Para obtener más información, consulte [Agente para Envoy](https://docs.aws.amazon.com//app-mesh/latest/userguide/appnet-agent.html) de App Mesh.
`APPNET_ENVOY_RESTART_COUNT`
Especifica el número de veces que el agente reiniciará el proceso del proxy de Envoy dentro de una tarea o pod en ejecución si se cierra. El agente también registra el estado de cierre cada vez que se cierra Envoy para facilitar la solución de problemas. El valor predeterminado de esta variable es `0`. Cuando se establece el valor predeterminado, el agente no intenta reiniciar el proceso.
Valor predeterminado: `0`
Máximo: `10`
`PID_POLL_INTERVAL_MS`
Especifica el intervalo en milisegundos durante el cual el agente comprueba el estado del proceso del proxy de Envoy. El valor predeterminado es `100`.
Valor predeterminado: `100`
Mínimo: `100`
Máximo: `1000`
`LISTENER_DRAIN_WAIT_TIME_S`
Especifica el tiempo en segundos durante el cual el proxy de Envoy espera a que se cierren las conexiones activas antes de finalizar el proceso.
Valor predeterminado: `20`
Mínimo: `5`
Máximo: `110`
`APPNET_AGENT_ADMIN_MODE`
Inicia el servidor de la interfaz de administración del agente y lo enlaza a una dirección tcp o un socket Unix.
Valores válidos: `tcp`, `uds`
`APPNET_AGENT_HTTP_PORT`
Especifique el puerto que se utilizará para enlazar la interfaz de administración del agente en el modo `tcp`. Asegúrese de que el valor del puerto sea > `1024` si `uid` \$1= `0`. Asegúrese de que el puerto sea menor que `65535`.
Valor predeterminado: `9902`
`APPNET_AGENT_ADMIN_UDS_PATH`
Especifique la ruta del socket de dominio de Unix para la interfaz de administración del agente en el modo `uds`.
Valor predeterminado: `/var/run/ecs/appnet_admin.sock`
### Variables de rastreo
Puede configurar uno o ninguno de los siguientes controladores de rastreo.
#### AWS X-Ray variables
Use las siguientes variables de entorno para configurar App Mesh con AWS X-Ray. Para obtener más información, consulte la [Guía para desarrolladores de AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/).
`ENABLE_ENVOY_XRAY_TRACING`
Habilita el rastreo de X-Ray mediante `127.0.0.1:2000` como punto de conexión del daemon predeterminado. Para habilitarlo, establezca el valor en `1`. El valor predeterminado es `0`.
`XRAY_DAEMON_PORT`
Especifique un valor de puerto para anular el puerto predeterminado del daemon de X-Ray: `2000`.
`XRAY_SAMPLING_RATE`
Especifique una frecuencia de muestreo para anular la frecuencia de muestreo predeterminada de X-Ray de `0.05` (5 %). Especifique el valor como un decimal entre `0` y `1.00` (100 %). Este valor se anula si se especifica `XRAY_SAMPLING_RULE_MANIFEST`. Esta variable es compatible con las imágenes de Envoy de la versión `v1.19.1.1-prod` y posterior.
`XRAY_SAMPLING_RULE_MANIFEST`
Especifique una ruta de archivo del sistema de archivos del contenedor de Envoy para configurar las reglas de muestreo personalizadas y localizadas para el rastreador de X-Ray. Para obtener más información, consulte [Reglas de muestreo](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-go-configuration.html#xray-sdk-go-configuration-sampling) en la *Guía para desarrolladores de AWS X-Ray *. Esta variable es compatible con las imágenes de Envoy de la versión `v1.19.1.0-prod` y posterior.
`XRAY_SEGMENT_NAME`
Especifique un nombre de segmento para los rastreos para anular el nombre de segmento predeterminado de X-Ray. De forma predeterminada, este valor se establecerá en `mesh/resourceName`. Esta variable es compatible con la versión `v1.23.1.0-prod` o posterior de la imagen de Envoy.
#### Variables de rastreo de Datadog
Las siguientes variables de entorno lo ayudan a configurar App Mesh con el rastreador de agentes de Datadog. Para obtener más información, consulte [Configuración del agente](https://docs.datadoghq.com/tracing/send_traces/) en la documentación de Datadog.
`ENABLE_ENVOY_DATADOG_TRACING`
Habilita la recopilación de rastros de Datadog utilizando `127.0.0.1:8126` como punto de conexión predeterminado del agente de Datadog. Para habilitarla, establezca el valor en `1` (el valor predeterminado es `0`).
`DATADOG_TRACER_PORT`
Especifique un valor de puerto para anular el puerto predeterminado del agente de Datadog: `8126`.
`DATADOG_TRACER_ADDRESS`
Especifique una dirección IP para anular la dirección predeterminada del agente de Datadog: `127.0.0.1`.
`DD_SERVICE`
Especifique un nombre de servicio para los rastreos a fin de anular el nombre de servicio predeterminado de Datadog: `envoy-meshName`/`virtualNodeName`. Esta variable es compatible con las imágenes de Envoy de la versión `v1.18.3.0-prod` y posterior.
#### Variables de rastreo de Jaeger
Utilice las siguientes variables de entorno para configurar App Mesh con el rastreo de Jaeger. Para obtener más información, consulte [Introducción](https://www.jaegertracing.io/docs/1.21/getting-started/) en la documentación de Jaeger. Estas variables son compatibles con las imágenes de Envoy de la versión `1.16.1.0-prod` y posterior.
`ENABLE_ENVOY_JAEGER_TRACING`
Habilita la recopilación de rastros de Jaeger utilizando `127.0.0.1:9411` como punto de conexión predeterminado de Jaeger. Para habilitarla, establezca el valor en `1` (el valor predeterminado es`0`).
`JAEGER_TRACER_PORT`
Especifique un valor de puerto para anular el puerto predeterminado de Jaeger: `9411`.
`JAEGER_TRACER_ADDRESS`
Especifique una dirección IP para anular la dirección predeterminada de Jaeger: `127.0.0.1`.
`JAEGER_TRACER_VERSION`
Especifique si el recopilador necesita rastreos en formato `JSON` o `PROTO` codificado. De forma predeterminada, este valor se establecerá en `PROTO`. Esta variable es compatible con la versión `v1.23.1.0-prod` o posterior de la imagen de Envoy.
#### Variable de rastreo de Envoy
Defina la siguiente variable de entorno para usar su propia configuración de rastreo.
`ENVOY_TRACING_CFG_FILE`
Especifique una ruta de archivo del sistema de archivos del contenedor de Envoy. Para obtener más información, 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) en la documentación de Envoy.
Si la configuración de rastreo requiere especificar un clúster de rastreo, asegúrese de que define la configuración del clúster asociado bajo `static_resources` en el mismo archivo de configuración de rastreo. Por ejemplo, Zipkin tiene un 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 el nombre de clúster que aloja los recopiladores de rastreos y dicho clúster debe definirse de forma estática.
### DogStatsVariables D
Usa las siguientes variables de entorno para configurar App Mesh con DogStats D. Para obtener más información, consulte la documentación de [DogStatsD.](https://docs.datadoghq.com/developers/dogstatsd/)
`ENABLE_ENVOY_DOG_STATSD`
Habilita las estadísticas DogStats D `127.0.0.1:8125` como punto final daemon predeterminado. Para habilitarlas, establezca el valor en `1`.
`STATSD_PORT`
Especifique un valor de puerto para anular el puerto del daemon DogStats D predeterminado.
`STATSD_ADDRESS`
Especifique un valor de dirección IP para anular la dirección IP predeterminada del DogStats daemon D. Predeterminado: `127.0.0.1`. Esta variable solo puede usarse con la versión `1.15.0` o posterior de la imagen de Envoy.
`STATSD_SOCKET_PATH`
Especifique un socket de dominio Unix para el daemon D. DogStats Si no se especifica esta variable y DogStats D está habilitada, este valor se establece de forma predeterminada en el puerto de direcciones IP del daemon DogStats D. `127.0.0.1:8125` Si se especifica que la `ENVOY_STATS_SINKS_CFG_FILE` variable contiene una configuración de sumideros de estadísticas, anula todas las variables D. DogStats Esta variable es compatible con la versión `v1.19.1.0-prod` o posterior de la imagen de Envoy.
### Variables de App Mesh
Las siguientes variables lo ayudan a configurar App Mesh.
`APPMESH_RESOURCE_CLUSTER`
De forma predeterminada, App Mesh utiliza el nombre del recurso especificado en `APPMESH_RESOURCE_ARN` cuando Envoy hace referencia a sí mismo en métricas y rastreos. Puede anular este comportamiento estableciendo la variable de entorno `APPMESH_RESOURCE_CLUSTER` con su propio nombre. Esta variable solo puede usarse con la versión `1.15.0` o posterior de la imagen de Envoy.
`APPMESH_METRIC_EXTENSION_VERSION`
Establezca el valor en `1` para habilitar la extensión de métricas de App Mesh. Para obtener más información acerca del uso de la extensión de métricas de App Mesh, consulte [Extensión de métricas de App Mesh](metrics.md).
`APPMESH_DUALSTACK_ENDPOINT`
Establezca el valor en `1` para conectar al punto de conexión de pila doble de App Mesh. Cuando este indicador está establecido, Envoy usa nuestro dominio compatible con pila doble. De forma predeterminada, este indicador está establecido en falso y solo se conecta a nuestro dominio `IPv4`. Esta variable solo se puede usar con la versión 1.22.0 o posterior de la imagen de Envoy.
### Variables de Envoy Stats
Utilice las siguientes variables de entorno para configurar App Mesh con Envoy Stats. Para obtener más información, consulte la documentación de [Envoy Stats](https://www.envoyproxy.io/docs/envoy/v1.6.0/api-v2/config/metrics/v2/stats.proto).
`ENABLE_ENVOY_STATS_TAGS`
Permite el uso de las etiquetas definidas por App Mesh `appmesh.mesh` y `appmesh.virtual_node`. [Para obtener más información, consulte config.metrics.v3. TagSpecifier](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-tagspecifier)en la documentación de Envoy. Para habilitarlas, establezca el valor en `1`.
`ENVOY_STATS_CONFIG_FILE`
Especifique una ruta de archivo del sistema de archivos del contenedor de Envoy para reemplazar el archivo de configuración predeterminado de etiquetas de estadísticas por el suyo propio. Para obtener más información, consulte [config.metrics.v3. StatsConfig](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-statsconfig).
Si se establece una configuración de estadísticas personalizada que incluya filtros de estadísticas, Envoy podría entrar en un estado en el que ya no se sincronice correctamente con el estado mundial de App Mesh. Se trata de un [error](https://github.com/envoyproxy/envoy/issues/9856) de Envoy. Nuestra recomendación es no filtrar las estadísticas en Envoy. Si el filtrado es absolutamente necesario, hemos incluido un par de soluciones alternativas para este [problema](https://github.com/aws/aws-app-mesh-roadmap/issues/283) en nuestra hoja de ruta.
`ENVOY_STATS_SINKS_CFG_FILE`
Especifique una ruta de archivo del sistema de archivos del contenedor de Envoy para sustituir la configuración predeterminada por la suya propia. Para obtener más información, consulte [config.metrics.v3. StatsSink](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-statssink)en la documentación de Envoy.
### Variables obsoletas
Las variables de entorno `APPMESH_VIRTUAL_NODE_NAME` y `APPMESH_RESOURCE_NAME` ya no son compatibles con la versión `1.15.0` o posterior de Envoy. Sin embargo, siguen siendo compatibles con las mallas existentes. En lugar de usar estas variables con la versión `1.15.0` o posterior de Envoy, use `APPMESH_RESOURCE_ARN` para todos los puntos de conexión de App Mesh.