Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Variables de configuration Envoy **Important** Avis de fin de support : le 30 septembre 2026, AWS le support pour AWS App Mesh. Après le 30 septembre 2026, vous ne pourrez plus accéder à la AWS App Mesh console ni aux AWS App Mesh ressources. Pour plus d'informations, consultez ce billet de blog [ Migration depuis Amazon ECS Service Connect AWS App Mesh](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect) vers Amazon ECS. Utilisez les variables d'environnement suivantes pour configurer les conteneurs Envoy pour les groupes de tâches de votre nœud virtuel App Mesh. **Note** App Mesh Envoy 1.17 ne prend pas en charge l'API xDS ** ** v2 d'Envoy. Si vous utilisez des variables de configuration [ Envoy ](https://docs.aws.amazon.com/app-mesh/latest/userguide/envoy-config.html) qui acceptent les fichiers de configuration Envoy, elles doivent être mises à jour avec la dernière ** API xDS ** v3. ## Variables requises La variable d'environnement suivante est requise pour tous les conteneurs App Mesh Envoy. Cette variable ne peut être utilisée qu'avec une version `1.15.0` ou une version ultérieure de l'image Envoy. Si vous utilisez une version antérieure de l'image, vous devez définir la `APPMESH_VIRTUAL_NODE_NAME` variable à la place. `APPMESH_RESOURCE_ARN` Lorsque vous ajoutez le conteneur Envoy à un groupe de tâches, définissez cette variable d'environnement sur l'ARN du nœud virtuel ou de la passerelle virtuelle que le groupe de tâches représente. La liste suivante contient des exemples d'ARN : + **Nœud virtuel ** — arn:aws:appmesh : ::mesh/ /VirtualNode/ {{Region-code}} {{111122223333}} {{meshName}} {{virtualNodeName}} + **Passerelle virtuelle ** — arn:aws:appmesh : ::mesh/ /VirtualGateway/ {{Region-code}} {{111122223333}} {{meshName}} {{virtualGatewayName}} ## Variables facultatives La variable d'environnement suivante est facultative pour les conteneurs App Mesh Envoy. `ENVOY_LOG_LEVEL` Spécifie le niveau de journalisation pour le conteneur Envoy. Valeurs valides: `trace`, `debug`, `info`, `warn`, `error`, `critical`, `off` Valeur par défaut : `info` `ENVOY_INITIAL_FETCH_TIMEOUT` Spécifie la durée pendant laquelle Envoy attend la première réponse de configuration du serveur de gestion pendant le processus d'initialisation. Pour plus d'informations, consultez la section Sources [ de configuration ](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) dans la documentation d'Envoy. Lorsqu’elle est définie sur `0`, il n’y a aucun délai d’attente. Valeur par défaut : `0` `ENVOY_CONCURRENCY` Définit l'option de ligne de `--concurrency` commande lors du démarrage de l'Envoy. Ce paramètre n'est pas défini par défaut. Cette option est disponible à partir de la version Envoy `v1.24.0.0-prod` ou supérieure. Pour plus d'informations, consultez la section Options de ligne de [ commande ](https://www.envoyproxy.io/docs/envoy/latest/operations/cli#cmdoption-concurrency) dans la documentation d'Envoy. ### Variables d'administration Utilisez ces variables d'environnement pour configurer l'interface administrative d'Envoy. `ENVOY_ADMIN_ACCESS_PORT` Spécifiez un port d'administration personnalisé sur lequel Envoy pourra écouter. Valeur par défaut : `9901`. Le port d'administration d'Envoy doit être différent de tout port d'écoute sur la passerelle virtuelle ou le nœud virtuel `ENVOY_ADMIN_ACCESS_LOG_FILE` Spécifiez un chemin personnalisé dans lequel écrire les journaux d'accès d'Envoy. Valeur par défaut : `/tmp/envoy_admin_access.log`. `ENVOY_ADMIN_ACCESS_ENABLE_IPV6` Active l'interface d'administration d'Envoy pour qu'elle accepte le `IPv6` trafic, ce qui permet à cette interface d'accepter à la fois le `IPv6` trafic `IPv4` et le trafic. Par défaut, cet indicateur est défini sur False et Envoy n'écoute que le `IPv4` trafic. Cette variable ne peut être utilisée qu'avec Envoy image version 1.22.0 ou ultérieure. ### Variables d'agent Utilisez ces variables d'environnement pour configurer l' AWS App Mesh agent pour Envoy. Pour plus d'informations, consultez App Mesh [ Agent pour Envoy](https://docs.aws.amazon.com/app-mesh/latest/userguide/appnet-agent.html). `APPNET_ENVOY_RESTART_COUNT` Spécifie le nombre de fois que l'agent redémarre le processus proxy Envoy au sein d'une tâche ou d'un module en cours d'exécution s'il se ferme. L'agent enregistre également l'état de sortie chaque fois qu'Envoy quitte pour faciliter le dépannage. La valeur par défaut de cette variable est `0`. Lorsque la valeur par défaut est définie, l'agent n'essaie pas de redémarrer le processus. Valeur par défaut : `0` Maximum : `10` `PID_POLL_INTERVAL_MS` Spécifie l'intervalle en millisecondes auquel l'état du processus du proxy Envoy est vérifié par l'agent. La valeur par défaut est `100`. Valeur par défaut : `100` Minimum : `100` Maximum : `1000` `LISTENER_DRAIN_WAIT_TIME_S` Spécifie la durée en secondes pendant laquelle le proxy Envoy attend la fermeture des connexions actives avant la fin du processus. Valeur par défaut : `20` Minimum : `5` Maximum : `110` `APPNET_AGENT_ADMIN_MODE` Démarre le serveur d'interface de gestion de l'Agent et le lie à une adresse TCP ou à un socket Unix. Valeurs valides : `tcp`, `uds` `APPNET_AGENT_HTTP_PORT` Spécifiez un port à utiliser pour lier l'interface de gestion de l'Agent en `tcp` mode. Assurez-vous que la valeur du port est > `1024` si `uid` \! =`0`. Assurez-vous que le port est inférieur à`65535`. Valeur par défaut : `9902` `APPNET_AGENT_ADMIN_UDS_PATH` Spécifiez le chemin du socket du domaine Unix pour l'interface de gestion de l'agent en `uds` mode. Valeur par défaut : `/var/run/ecs/appnet_admin.sock` ### Variables de suivi Vous ne pouvez configurer aucun ou l'un des pilotes de suivi suivants. #### AWS X-Ray variables Utilisez les variables d'environnement suivantes pour configurer App Mesh avec AWS X-Ray. Pour plus d’informations, consultez le [Guide du développeur AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/). `ENABLE_ENVOY_XRAY_TRACING` Active le X-Ray traçage en l'utilisant `127.0.0.1:2000` comme point de terminaison du démon par défaut. Pour l'activer, définissez la valeur sur`1`. La valeur par défaut est `0`. `XRAY_DAEMON_PORT` Spécifiez une valeur de port pour remplacer le port du X-Ray démon par défaut :. `2000` `XRAY_SAMPLING_RATE` Spécifiez un taux d'échantillonnage pour remplacer le taux d'échantillonnage par défaut du X-Ray traceur de `0.05` (5 %). Spécifiez la valeur sous la forme d'une décimale comprise entre `0` et `1.00` (100 %). Cette valeur est remplacée si elle `XRAY_SAMPLING_RULE_MANIFEST` est spécifiée. Cette variable est prise en charge avec les images Envoy de la version `v1.19.1.1-prod` et des versions ultérieures. `XRAY_SAMPLING_RULE_MANIFEST` Spécifiez un chemin de fichier dans le système de fichiers du conteneur Envoy pour configurer les règles d'échantillonnage personnalisées localisées pour le X-Ray traceur. Pour plus d'informations, consultez la section Règles [ d'échantillonnage ](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-go-configuration.html#xray-sdk-go-configuration-sampling) dans le Guide du *AWS X-Ray développeur*. Cette variable est prise en charge avec les images Envoy de la version `v1.19.1.0-prod` et des versions ultérieures. `XRAY_SEGMENT_NAME` Spécifiez un nom de segment pour les traces afin de remplacer le nom de X-Ray segment par défaut. Par défaut, cette valeur sera définie comme`mesh/resourceName`. Cette variable est prise en charge avec la version d'image Envoy `v1.23.1.0-prod` ou une version ultérieure. #### Variables de suivi Datadog Les variables d'environnement suivantes vous aident à configurer App Mesh avec le traceur de l'agent Datadog. Pour plus d'informations, consultez la section Configuration de l'[agent ](https://docs.datadoghq.com/tracing/send_traces/) dans la documentation Datadog. `ENABLE_ENVOY_DATADOG_TRACING` Active la collecte de traces Datadog en l'utilisant `127.0.0.1:8126` comme point de terminaison par défaut de l'agent Datadog. Pour l'activer, définissez la valeur sur `1` (la valeur par défaut est`0`). `DATADOG_TRACER_PORT` Spécifiez une valeur de port pour remplacer le port par défaut de l'agent Datadog :. `8126` `DATADOG_TRACER_ADDRESS` Spécifiez une adresse IP pour remplacer l'adresse par défaut de l'agent Datadog : `127.0.0.1` `DD_SERVICE` Spécifiez un nom de service pour les traces afin de remplacer le nom de service Datadog par défaut :/. `envoy-meshName` `virtualNodeName` Cette variable est prise en charge avec les images Envoy de la version `v1.18.3.0-prod` et des versions ultérieures. #### Variables de suivi Jaeger Utilisez les variables d'environnement suivantes pour configurer App Mesh avec le traçage Jaeger. Pour plus d'informations, consultez la section [ Getting Started ](https://www.jaegertracing.io/docs/1.21/getting-started/) dans la documentation Jaeger. Ces variables sont prises en charge avec les images Envoy de la version `1.16.1.0-prod` et des versions ultérieures. `ENABLE_ENVOY_JAEGER_TRACING` Active la collecte de traces Jaeger en l'utilisant `127.0.0.1:9411` comme point de terminaison Jaeger par défaut. Pour l'activer, définissez la valeur sur `1` (la valeur par défaut est`0`). `JAEGER_TRACER_PORT` Spécifiez une valeur de port pour remplacer le port Jaeger par défaut :. `9411` `JAEGER_TRACER_ADDRESS` Spécifiez une adresse IP pour remplacer l'adresse Jaeger par défaut :. `127.0.0.1` `JAEGER_TRACER_VERSION` Spécifiez si le collecteur a besoin de traces au format `PROTO` codé `JSON` ou codé. Par défaut, cette valeur sera définie sur`PROTO`. Cette variable est prise en charge avec la version d'image Envoy `v1.23.1.0-prod` ou une version ultérieure. #### Variable de suivi Envoy Définissez la variable d'environnement suivante pour utiliser votre propre configuration de suivi. `ENVOY_TRACING_CFG_FILE` Spécifiez un chemin de fichier dans le système de fichiers conteneur Envoy. Pour plus d'informations, consultez [`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) la documentation d'Envoy. Si la configuration de suivi nécessite la spécification d'un cluster de suivi, assurez-vous de configurer la configuration de cluster associée `static_resources` dans le même fichier de configuration de suivi. Par exemple, Zipkin possède un [`collector_cluster`](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/trace/v3/zipkin.proto#config-trace-v3-zipkinconfig) champ pour le nom du cluster qui héberge les collecteurs de traces, et ce cluster doit être défini statiquement. ### DogStatsVariables D Utilisez les variables d'environnement suivantes pour configurer App Mesh avec DogStats D. Pour plus d'informations, consultez la [ documentation ](https://docs.datadoghq.com/developers/dogstatsd/) DogStats D. `ENABLE_ENVOY_DOG_STATSD` Active les statistiques DogStats D en l'utilisant `127.0.0.1:8125` comme point de terminaison du démon par défaut. Pour l'activer, définissez la valeur sur`1`. `STATSD_PORT` Spécifiez une valeur de port pour remplacer le port du démon DogStats D par défaut. `STATSD_ADDRESS` Spécifiez une valeur d'adresse IP pour remplacer l'adresse IP par défaut du démon DogStats D. Valeur par défaut : `127.0.0.1`. Cette variable ne peut être utilisée qu'avec une version `1.15.0` ou une version ultérieure de l'image Envoy. `STATSD_SOCKET_PATH` Spécifiez un socket de domaine Unix pour le DogStats démon D. Si cette variable n'est pas spécifiée et que DogStats D est activé, cette valeur est par défaut le port d'adresse IP du démon DogStats D. `127.0.0.1:8125` Si la `ENVOY_STATS_SINKS_CFG_FILE` variable spécifiée contient une configuration de puits de statistiques, elle remplace toutes les variables DogStats D. Cette variable est prise en charge avec la version d'image Envoy `v1.19.1.0-prod` ou une version ultérieure. ### Variables App Mesh Les variables suivantes vous aident à configurer App Mesh. `APPMESH_RESOURCE_CLUSTER` Par défaut, App Mesh utilise le nom de la ressource que vous avez spécifiée `APPMESH_RESOURCE_ARN` lorsqu'Envoy fait référence à elle-même dans les métriques et les traces. Vous pouvez remplacer ce comportement en définissant la variable d'environnement `APPMESH_RESOURCE_CLUSTER` avec votre propre nom. Cette variable ne peut être utilisée qu'avec une version `1.15.0` ou une version ultérieure de l'image Envoy. `APPMESH_METRIC_EXTENSION_VERSION` Définissez la valeur sur `1` pour activer l'extension de métriques App Mesh. Pour plus d'informations sur l'utilisation de l'extension App Mesh metrics, consultez[Extension de métriques pour App Mesh](metrics.md). `APPMESH_DUALSTACK_ENDPOINT` Définissez la valeur sur pour vous connecter `1` au point de terminaison App Mesh Dual Stack. Lorsque cet indicateur est activé, Envoy utilise notre domaine compatible avec la double pile. Par défaut, cet indicateur est défini sur false et se connecte uniquement à notre `IPv4` domaine. Cette variable ne peut être utilisée qu'avec Envoy image version 1.22.0 ou ultérieure. ### Variables statistiques d'Envoy Utilisez les variables d'environnement suivantes pour configurer App Mesh avec Envoy Stats. Pour plus d'informations, consultez la [ documentation d'](https://www.envoyproxy.io/docs/envoy/v1.6.0/api-v2/config/metrics/v2/stats.proto)Envoy Stats. `ENABLE_ENVOY_STATS_TAGS` Permet d'utiliser les balises définies par App Mesh `appmesh.mesh` et`appmesh.virtual_node`. Pour plus d'informations, consultez [ config.metrics.v3. TagSpecifier](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-tagspecifier)dans la documentation d'Envoy. Pour l'activer, définissez la valeur sur`1`. `ENVOY_STATS_CONFIG_FILE` Spécifiez un chemin de fichier dans le système de fichiers conteneur Envoy pour remplacer le fichier de configuration des balises Stats par défaut par le vôtre. Pour plus d'informations, consultez [ config.metrics.v3. StatsConfig](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-statsconfig). La définition d'une configuration de statistiques personnalisée incluant des filtres de statistiques peut amener Envoy à entrer dans un état dans lequel il ne se synchronisera plus correctement avec l'état mondial d'App Mesh. Il s'agit d'un [ bogue ](https://github.com/envoyproxy/envoy/issues/9856) dans Envoy. Nous vous recommandons de ne pas filtrer les statistiques dans Envoy. Si le filtrage est absolument nécessaire, nous avons répertorié quelques solutions de contournement dans ce [ numéro de notre feuille de ](https://github.com/aws/aws-app-mesh-roadmap/issues/283) route. `ENVOY_STATS_SINKS_CFG_FILE` Spécifiez un chemin de fichier dans le système de fichiers du conteneur Envoy pour remplacer la configuration par défaut par la vôtre. Pour plus d'informations, consultez [ config.metrics.v3. StatsSink](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-statssink)dans la documentation d'Envoy. ### Variables obsolètes Les variables `APPMESH_VIRTUAL_NODE_NAME` d'environnement ne `APPMESH_RESOURCE_NAME` sont plus prises en charge dans la version Envoy `1.15.0` ou une version ultérieure. Cependant, ils sont toujours pris en charge pour les maillages existants. Au lieu d'utiliser ces variables avec la version d'Envoy `1.15.0` ou une version ultérieure, utilisez-les `APPMESH_RESOURCE_ARN` pour tous les points de terminaison App Mesh.