View a markdown version of this page

Envoy-Konfigurationsvariablen - AWS App Mesh

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Envoy-Konfigurationsvariablen

Wichtig

Hinweis zum Ende des Supports: Am 30. September 2026 AWS wird der Support für eingestellt. AWS App Mesh Nach dem 30. September 2026 werden Sie nicht mehr auf die AWS App Mesh Konsole oder die Ressourcen zugreifen können. AWS App Mesh Weitere Informationen finden Sie in diesem Blogbeitrag Migration von AWS App Mesh zu Amazon ECS Service Connect.

Verwenden Sie die folgenden Umgebungsvariablen, um die Envoy-Container für Ihre Aufgabengruppen mit virtuellen App Mesh-Knoten 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 einer Version 1.15.0 oder einer höheren 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: ::mesh/ /VirtualNode/ Region-code 111122223333 meshName virtualNodeName

  • Virtuelles Gateway — arn:aws:appmesh: Region-code ::mesh/ /VirtualGateway/ 111122223333 meshName virtualGatewayName

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 in der Envoy-Dokumentation unter Konfigurationsquellen. Wenn auf 0 eingestellt, gibt es kein Timeout.

Standard: 0

ENVOY_CONCURRENCY

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

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

Admin-Variablen

Verwenden Sie diese Umgebungsvariablen, um die Verwaltungsoberflä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 allen Listener-Ports auf dem virtuellen Gateway oder virtuellen Knoten unterscheiden

ENVOY_ADMIN_ACCESS_LOG_FILE

Geben Sie einen benutzerdefinierten Pfad an, in den die 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 akzeptiert. 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.

Agenten-Variablen

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

APPNET_ENVOY_RESTART_COUNT

Gibt an, wie oft der Agent den Envoy-Proxy-Prozess innerhalb einer laufenden Aufgabe oder eines Pods neu startet, wenn dieser beendet wird. Der Agent protokolliert außerdem den Exit-Status jedes Mal, wenn Envoy beendet wird, um die Fehlerbehebung zu erleichtern. Der Standardwert dieser Variable lautet 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 an, wie lange der Envoy-Proxy auf das Schließen aktiver Verbindungen wartet, bevor der Prozess beendet wird, in Sekunden.

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 das Binden 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 als ist65535.

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 variables

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

ENABLE_ENVOY_XRAY_TRACING

Aktiviert X-Ray die Ablaufverfolgung 127.0.0.1:2000 als Standard-Daemon-Endpunkt. Um dies zu aktivieren, setzen Sie den Wert auf. 1 Der Standardwert ist 0.

XRAY_DAEMON_PORT

Geben Sie einen Portwert an, um den X-Ray Standard-Daemon-Port zu überschreiben:2000.

XRAY_SAMPLING_RATE

Geben Sie eine Abtastrate an, um die Standard-Abtastrate des X-Ray Tracers von 0.05 (5%) außer Kraft zu setzen. Geben Sie den Wert als Dezimalzahl zwischen 0 und 1.00 (100%) an. Dieser Wert wird außer Kraft gesetzt, wenn er angegeben XRAY_SAMPLING_RULE_MANIFEST wird. Diese Variable wird mit Envoy-Images der Version v1.19.1.1-prod 4 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 Entwicklerhandbuch. Diese Variable wird mit Envoy-Images der Version 4 v1.19.1.0-prod und höher unterstützt.

XRAY_SEGMENT_NAME

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

Variablen für die Datadog-Protokollierung

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 standardmäßigen Datadog-Agent-Endpunkt. Um dies zu aktivieren, setzen Sie den Wert auf 1 (der Standardwert ist). 0

DATADOG_TRACER_PORT

Geben Sie einen Portwert an, um den Standardport des Datadog-Agenten zu überschreiben:. 8126

DATADOG_TRACER_ADDRESS

Geben Sie eine IP-Adresse an, um die Standard-Datadog-Agentenadresse 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 4 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 mit Envoy-Images der Version 4 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 dies zu aktivieren, setzen Sie den Wert auf 1 (der Standardwert ist0).

JAEGER_TRACER_PORT

Geben Sie einen Portwert an, um den Standard-Jaeger-Anschluss zu überschreiben:9411.

JAEGER_TRACER_ADDRESS

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

JAEGER_TRACER_VERSION

Geben Sie an, ob der Collector Traces im JSON oder im PROTO kodierten Format benötigt. Standardmäßig wird dieser Wert auf gesetztPROTO. Diese Variable wird in 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 Protokollierungskonfiguration zu verwenden.

ENVOY_TRACING_CFG_FILE

Geben Sie einen Dateipfad im Envoy-Container-Dateisystem an. Weitere Informationen finden Sie config.trace.v3.Tracing in 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_cluster Feld 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 DogStats D-Dokumentation.

ENABLE_ENVOY_DOG_STATSD

Aktiviert DogStats D Stats 127.0.0.1:8125 als Standard-Daemon-Endpunkt. Um dies 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 einer Version 1.15.0 oder einer höheren 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 ist und DogStats D aktiviert ist, wird für diesen Wert standardmäßig der DogStats D-Daemon-IP-Adressport von verwendet. 127.0.0.1:8125 Wenn die ENVOY_STATS_SINKS_CFG_FILE Variable angegeben wird, die eine Stats-Sink-Konfiguration enthält, überschreibt sie alle D-Variablen. DogStats Diese Variable wird in der Envoy-Image-Version v1.19.1.0-prod oder höher unterstützt.

App Mesh-Variablen

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

APPMESH_RESOURCE_CLUSTER

Standardmäßig verwendet App Mesh den Namen der Ressource, den Sie angegeben haben, APPMESH_RESOURCE_ARN als 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 einer Version 1.15.0 oder einer höheren Version des Envoy-Images verwendet werden.

APPMESH_METRIC_EXTENSION_VERSION

Stellen Sie den Wert auf ein, 1 um die App Mesh-Metrikerweiterung zu aktivieren. Weitere Informationen zur Verwendung der App Mesh Metrics Extension finden Sie unterMetrics-Erweiterung 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.

Statistik-Variablen für Envoy

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

ENABLE_ENVOY_STATS_TAGS

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

ENVOY_STATS_CONFIG_FILE

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

Anmerkung

Das Einrichten einer benutzerdefinierten Statistikkonfiguration, die Statistikfilter beinhaltet, kann dazu führen, dass Envoy in einen Zustand gerät, in dem es nicht mehr ordnungsgemäß mit dem App Mesh-Status der Welt synchronisiert wird. Das ist ein Bug in Envoy. Wir empfehlen, die Statistiken in Envoy nicht zu filtern. Wenn das Filtern 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 durch Ihre eigene 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-Endpunkte.