View a markdown version of this page

Variables de configuration Envoy - AWS App Mesh
Variables requisesVariables facultatives

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

Note

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.

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.

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 sur1. 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 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 commemesh/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 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 est0).

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 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 est0).

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 surPROTO. 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 la documentation d'Envoy.

Note

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

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, consultezExtension de métriques pour App Mesh.

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'Envoy Stats.

ENABLE_ENVOY_STATS_TAGS

Permet d'utiliser les balises définies par App Mesh appmesh.mesh etappmesh.virtual_node. Pour plus d'informations, consultez config.metrics.v3. TagSpecifierdans la documentation d'Envoy. Pour l'activer, définissez la valeur sur1.

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.

Note

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