Envoy-Konfigurationsvariablen

Verwenden Sie die folgenden Umgebungsvariablen, um die Envoy-Container für Ihre virtuellen App Mesh Mesh-Node-Aufgabengruppen zu konfigurieren.

Anmerkung

App Mesh Envoy 1.17 unterstützt die v2 xDS-API von Envoy nicht. Wenn Sie Envoy-Konfigurationsvariablen verwenden, die Envoy-Konfigurationsdateien akzeptieren, müssen diese auf die neueste v3-xDS-API aktualisiert werden.

Erforderliche Variablen

Die folgende Umgebungsvariable ist für alle App Mesh Envoy-Container erforderlich. Diese Variable kann nur mit der Version 1.15.0 oder einer späteren Version des Envoy-Images verwendet werden. Wenn Sie eine frühere Version des Images verwenden, müssen Sie stattdessen die APPMESH_VIRTUAL_NODE_NAME Variable festlegen.

APPMESH_RESOURCE_ARN

Wenn Sie den Envoy-Container zu einer Aufgabengruppe hinzufügen, setzen Sie diese Umgebungsvariable auf den ARN des virtuellen Knotens oder des virtuellen Gateways, das die Aufgabengruppe darstellt. Die folgende Liste enthält Beispiel-ARNs:

• Virtueller Knoten — arn:aws:appmesh: Regionalcode: 111122223333:mesh/ meshName /VirtualNode/ virtual NodeName

• Virtuelles Gateway — arn:aws:appmesh: Regionalcode: 111122223333:mesh/ meshName /virtualGateway/ virtual GatewayName

Bei Verwendung des App Mesh Mesh-Vorschaukanals müssen ARNs die Region us-west-2 verwenden und stattdessen verwendenappmesh-preview. appmesh Zum Beispiel ist der ARN eines virtuellen Knotens im App Mesh Preview Channelarn:aws:appmesh-preview:us-west-2:111122223333:mesh/meshName/virtualNode/virtualNodeName.

Optionale Variablen

Die folgende Umgebungsvariable ist für App Mesh Envoy-Container optional.

ENVOY_LOG_LEVEL

Gibt die Protokollebene für den Envoy-Container an.

Zulässige Werte: trace, debug, info, warn, error, critical, off

Standard: info

ENVOY_INITIAL_FETCH_TIMEOUT

Gibt an, wie lange Envoy während des Initialisierungsvorgangs auf die erste Konfigurationsantwort vom Management-Server wartet.

Weitere Informationen finden Sie unter Konfigurationsquellen in der Envoy-Dokumentation. Wenn auf gesetzt0, gibt es kein Timeout.

Standard: 0

ENVOY_CONCURRENCY

Legt die --concurrency Befehlszeilenoption beim Starten des Envoy fest. Dies ist standardmäßig nicht festgelegt. Diese Option ist ab der Envoy-Version v1.24.0.0-prod oder höher verfügbar.

Weitere Informationen finden Sie unter Befehlszeilenoptionen in der Envoy-Dokumentation.

Admin-Variablen

Verwenden Sie diese Umgebungsvariablen, um die Administrationsoberfläche von Envoy zu konfigurieren.

ENVOY_ADMIN_ACCESS_PORT

Geben Sie einen benutzerdefinierten Admin-Port an, den Envoy abhören soll. Standard: 9901.

Anmerkung

Der Envoy-Admin-Port sollte sich von jedem Listener-Port auf dem virtuellen Gateway oder virtuellen Knoten unterscheiden

ENVOY_ADMIN_ACCESS_LOG_FILE

Geben Sie einen benutzerdefinierten Pfad an, in den Envoy-Zugriffsprotokolle geschrieben werden sollen. Standard: /tmp/envoy_admin_access.log.

ENVOY_ADMIN_ACCESS_ENABLE_IPV6

Schaltet die Administrationsoberfläche von Envoy so um, dass sie IPv6 Datenverkehr akzeptiert, sodass diese Schnittstelle sowohl IPv4 Datenverkehr als auch Datenverkehr akzeptieren kann. IPv6 Standardmäßig ist dieses Flag auf False gesetzt und Envoy hört nur den Datenverkehr ab. IPv4 Diese Variable kann nur mit der Envoy-Image-Version 1.22.0 oder höher verwendet werden.

Agentenvariablen

Verwenden Sie diese Umgebungsvariablen, um den AWS App Mesh Agenten für Envoy zu konfigurieren. Weitere Informationen finden Sie unter App Mesh Agent for Envoy.

APPNET_ENVOY_RESTART_COUNT

Gibt an, wie oft der Agent den Envoy-Proxyprozess innerhalb einer laufenden Aufgabe oder eines Pods neu startet, wenn dieser beendet wird. Der Agent protokolliert außerdem bei jedem Beenden von Envoy den Exit-Status, um die Fehlerbehebung zu erleichtern. Der Standardwert dieser Variablen ist. 0 Wenn der Standardwert festgelegt ist, versucht der Agent nicht, den Prozess neu zu starten.

Standard: 0

Maximum: 10

PID_POLL_INTERVAL_MS

Gibt das Intervall in Millisekunden an, in dem der Prozessstatus des Envoy-Proxys vom Agenten überprüft wird. Der Standardwert ist 100.

Standard: 100

Minimum: 100

Maximum: 1000

LISTENER_DRAIN_WAIT_TIME_S

Gibt die Zeitspanne in Sekunden an, für die der Envoy-Proxy auf das Schließen aktiver Verbindungen wartet, bevor der Prozess beendet wird.

Standard: 20

Minimum: 5

Maximum: 110

APPNET_AGENT_ADMIN_MODE

Startet den Management-Interface-Server des Agenten und bindet ihn entweder an eine TCP-Adresse oder einen Unix-Socket.

Zulässige Werte: tcp, uds

APPNET_AGENT_HTTP_PORT

Geben Sie einen Port an, der für die Bindung der Verwaltungsschnittstelle des Agenten im tcp Modus verwendet werden soll. Stellen Sie sicher, dass der Portwert > 1024 if istuid! =0. Stellen Sie sicher, dass der Port kleiner ist als65535.

Standard: 9902

APPNET_AGENT_ADMIN_UDS_PATH

Geben Sie den Unix-Domain-Socket-Pfad für die Verwaltungsschnittstelle des Agenten im uds Modus an.

Standard: /var/run/ecs/appnet_admin.sock

Variablen verfolgen

Sie können keinen oder einen der folgenden Ablaufverfolgungstreiber konfigurieren.

AWS X-Ray Variablen

Verwenden Sie die folgenden Umgebungsvariablen, um App Mesh mit zu konfigurieren AWS X-Ray. Weitere Informationen finden Sie im AWS X-Ray -Entwicklerhandbuch.

ENABLE_ENVOY_XRAY_TRACING

Aktiviert die Röntgenverfolgung 127.0.0.1:2000 als Standard-Daemon-Endpunkt. Um ihn zu aktivieren, setzen Sie den Wert auf. 1 Der Standardwert ist 0.

XRAY_DAEMON_PORT

Geben Sie einen Portwert an, um den standardmäßigen X-Ray-Daemon-Port zu überschreiben:2000.

XRAY_SAMPLING_RATE

Geben Sie eine Abtastrate an, um die standardmäßige Abtastrate des Röntgen-Tracers von 0.05 (5%) zu überschreiben. Geben Sie den Wert als Dezimalzahl zwischen 0 und 1.00 (100%) an. Dieser Wert wird überschrieben, wenn er angegeben XRAY_SAMPLING_RULE_MANIFEST ist. Diese Variable wird mit Envoy-Images der Version v1.19.1.1-prod und höher unterstützt.

XRAY_SAMPLING_RULE_MANIFEST

Geben Sie einen Dateipfad im Envoy-Container-Dateisystem an, um die lokalisierten benutzerdefinierten Sampling-Regeln für den X-Ray Tracer zu konfigurieren. Weitere Informationen finden Sie unter Sampling-Regeln im AWS X-Ray Developer Guide. Diese Variable wird mit Envoy-Images der Version 7 v1.19.1.0-prod und höher unterstützt.

XRAY_SEGMENT_NAME

Geben Sie einen Segmentnamen für Traces an, um den standardmäßigen X-Ray-Segmentnamen zu überschreiben. Standardmäßig wird dieser Wert als gesetztmesh/resourceName. Diese Variable wird mit der Envoy-Image-Version v1.23.1.0-prod oder höher unterstützt.

Datadog-Tracing-Variablen

Die folgenden Umgebungsvariablen helfen Ihnen bei der Konfiguration von App Mesh mit dem Datadog Agent Tracer. Weitere Informationen finden Sie unter Agentenkonfiguration in der Datadog-Dokumentation.

ENABLE_ENVOY_DATADOG_TRACING

Aktiviert die Datadog-Trace-Erfassung 127.0.0.1:8126 als Standard-Datadog-Agent-Endpunkt. Um ihn zu aktivieren, setzen Sie den Wert auf 1 (der Standardwert ist). 0

DATADOG_TRACER_PORT

Geben Sie einen Portwert an, um den standardmäßigen Datadog-Agent-Port zu überschreiben:. 8126

DATADOG_TRACER_ADDRESS

Geben Sie eine IP-Adresse an, um die Standardadresse des Datadog-Agenten zu überschreiben:. 127.0.0.1

DD_SERVICE

Geben Sie einen Dienstnamen für Traces an, um den standardmäßigen Datadog-Dienstnamen zu überschreiben:/. envoy-meshName virtualNodeName Diese Variable wird mit Envoy-Images der Version v1.18.3.0-prod und höher unterstützt.

Jaeger-Tracing-Variablen

Verwenden Sie die folgenden Umgebungsvariablen, um App Mesh mit Jaeger-Tracing zu konfigurieren. Weitere Informationen finden Sie unter Erste Schritte in der Jaeger-Dokumentation. Diese Variablen werden von Envoy-Images der Version 1.16.1.0-prod und höher unterstützt.

ENABLE_ENVOY_JAEGER_TRACING

Aktiviert die Jaeger-Trace-Erfassung 127.0.0.1:9411 als Standard-Jaeger-Endpunkt. Um ihn zu aktivieren, setzen Sie den Wert auf 1 (der Standardwert ist0).

JAEGER_TRACER_PORT

Geben Sie einen Portwert an, um den Standardport von Jaeger zu überschreiben:9411.

JAEGER_TRACER_ADDRESS

Geben Sie eine IP-Adresse an, um die Standardadresse von Jaeger zu überschreiben:. 127.0.0.1

JAEGER_TRACER_VERSION

Geben Sie an, ob der Collector Traces im JSON oder PROTO codierten Format benötigt. Standardmäßig ist dieser Wert auf gesetztPROTO. Diese Variable wird mit der Envoy-Image-Version v1.23.1.0-prod oder höher unterstützt.

Envoy-Tracing-Variable

Stellen Sie die folgende Umgebungsvariable ein, um Ihre eigene Ablaufverfolgungskonfiguration zu verwenden.

ENVOY_TRACING_CFG_FILE

Geben Sie einen Dateipfad im Envoy-Container-Dateisystem an. Weitere Informationen finden Sie config.trace.v3.Tracingin der Envoy-Dokumentation.

Anmerkung

Wenn die Tracing-Konfiguration die Angabe eines Tracing-Clusters erfordert, stellen Sie sicher, dass Sie die zugehörige Cluster-Konfiguration unter static_resources in derselben Tracing-Konfigurationsdatei konfigurieren. Zipkin hat beispielsweise ein collector_clusterFeld für den Clusternamen, der die Trace-Collectors hostet, und dieser Cluster muss statisch definiert werden.

DogStatsD-Variablen

Verwenden Sie die folgenden Umgebungsvariablen, um App Mesh mit DogStats D zu konfigurieren. Weitere Informationen finden Sie in der DogStatsD-Dokumentation.

ENABLE_ENVOY_DOG_STATSD

Aktiviert DogStats D Stats 127.0.0.1:8125 als Standard-Daemon-Endpunkt. Um zu aktivieren, setzen Sie den Wert auf1.

STATSD_PORT

Geben Sie einen Portwert an, um den DogStats Standard-D-Daemon-Port zu überschreiben.

STATSD_ADDRESS

Geben Sie einen IP-Adresswert an, um die DogStats Standard-D-Daemon-IP-Adresse zu überschreiben. Standard: 127.0.0.1. Diese Variable kann nur mit der Version 1.15.0 oder einer späteren Version des Envoy-Images verwendet werden.

STATSD_SOCKET_PATH

Geben Sie einen Unix-Domain-Socket für den DogStats D-Daemon an. Wenn diese Variable nicht angegeben und DogStats D aktiviert ist, wird für diesen Wert standardmäßig der IP-Adressport des DogStats D-Daemons von verwendet. 127.0.0.1:8125 Wenn die ENVOY_STATS_SINKS_CFG_FILE Variable angegeben wird, die eine Statistiksenkenkonfiguration enthält, überschreibt sie alle D-Variablen. DogStats Diese Variable wird mit der Envoy-Image-Version v1.19.1.0-prod oder höher unterstützt.

App Mesh Mesh-Variablen

Die folgenden Variablen helfen Ihnen bei der Konfiguration von App Mesh.

APPMESH_PREVIEW

Stellen Sie den Wert auf ein, 1 um eine Verbindung zum App Mesh Preview Channel-Endpunkt herzustellen. Weitere Informationen zur Verwendung des App Mesh Mesh-Vorschaukanals finden Sie unterApp Mesh Preview Channel.

APPMESH_RESOURCE_CLUSTER

Standardmäßig verwendet App Mesh den Namen der Ressource, die Sie angegeben haben, APPMESH_RESOURCE_ARN wenn Envoy in Metriken und Traces auf sich selbst verweist. Sie können dieses Verhalten übergehen, indem Sie die APPMESH_RESOURCE_CLUSTER-Umgebungsvariable mit Ihrem eigenen Namen festlegen. Diese Variable kann nur mit der Version 1.15.0 oder einer späteren Version des Envoy-Images verwendet werden.

APPMESH_METRIC_EXTENSION_VERSION

Legen Sie den Wert auf fest, 1 um die App Mesh-Metrikerweiterung zu aktivieren. Weitere Informationen zur Verwendung der App Mesh-Metrikerweiterung finden Sie unterMetrikerweiterung für App Mesh.

APPMESH_DUALSTACK_ENDPOINT

Stellen Sie den Wert auf ein, 1 um eine Verbindung zum App Mesh Dual Stack-Endpunkt herzustellen. Wenn dieses Flag gesetzt ist, verwendet Envoy unsere Dual-Stack-fähige Domain. Standardmäßig ist dieses Flag auf False gesetzt und stellt nur eine Verbindung zu unserer IPv4 Domain her. Diese Variable kann nur mit der Envoy-Image-Version 1.22.0 oder höher verwendet werden.

Envoy-Statistikvariablen

Verwenden Sie die folgenden Umgebungsvariablen, um App Mesh mit Envoy Stats zu konfigurieren. Weitere Informationen finden Sie in der Dokumentation zu Envoy Stats.

ENABLE_ENVOY_STATS_TAGS

Ermöglicht die Verwendung von App Mesh Mesh-definierten Tags appmesh.mesh undappmesh.virtual_node. Weitere Informationen finden Sie unter config.metrics.v3. TagSpecifierin der Envoy-Dokumentation. Um zu aktivieren, setzen Sie den Wert auf1.

ENVOY_STATS_CONFIG_FILE

Geben Sie einen Dateipfad im Envoy-Container-Dateisystem an, um die standardmäßige Konfigurationsdatei für die Statistik-Tags durch Ihre eigene zu überschreiben. Weitere Informationen finden Sie unter config.metrics.v3. StatsConfig.

Anmerkung

Das Einrichten einer benutzerdefinierten Statistikkonfiguration mit Statistikfiltern kann dazu führen, dass Envoy in einen Status wechselt, in dem es nicht mehr ordnungsgemäß mit dem App Mesh Mesh-Status der Welt synchronisiert wird. Das ist ein Bug in Envoy. Wir empfehlen, in Envoy keine Statistiken zu filtern. Wenn eine Filterung unbedingt erforderlich ist, haben wir in dieser Ausgabe auf unserer Roadmap einige Problemumgehungen aufgeführt.

ENVOY_STATS_SINKS_CFG_FILE

Geben Sie einen Dateipfad im Envoy-Container-Dateisystem an, um die Standardkonfiguration mit Ihrer eigenen zu überschreiben. Weitere Informationen finden Sie unter config.metrics.v3. StatsSinkin der Envoy-Dokumentation.

Veraltete Variablen

Die Umgebungsvariablen APPMESH_VIRTUAL_NODE_NAME und APPMESH_RESOURCE_NAME werden in der Envoy-Version 1.15.0 oder höher nicht mehr unterstützt. Sie werden jedoch weiterhin für bestehende Meshes unterstützt. Anstatt diese Variablen mit der Envoy-Version 1.15.0 oder höher zu verwenden, verwenden Sie sie APPMESH_RESOURCE_ARN für alle App Mesh Mesh-Endpunkte.