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-code111122223333meshNamevirtualNodeName -
Virtuelles Gateway — arn:aws:appmesh:
Region-code::mesh/ /VirtualGateway/111122223333meshNamevirtualGatewayName
-
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,offStandard:
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 0eingestellt, gibt es kein Timeout.Standard:
0 ENVOY_CONCURRENCY-
Legt die
--concurrencyBefehlszeilenoption beim Starten von Envoy fest. Dies ist nicht standardmäßig festgelegt. Diese Option ist ab der Envoy-Versionv1.24.0.0-prododer 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
IPv6Datenverkehr akzeptiert, sodass diese Schnittstelle sowohlIPv4Datenverkehr als auch Datenverkehr akzeptiert.IPv6Standardmäßig ist dieses Flag auf False gesetzt, und Envoy hört nur den Datenverkehr ab.IPv4Diese 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:
0Maximum:
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:
100Minimum:
100Maximum:
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:
20Minimum:
5Maximum:
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
tcpModus verwendet werden soll. Stellen Sie sicher, dass der Portwert >1024if 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
udsModus 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:2000als Standard-Daemon-Endpunkt. Um dies zu aktivieren, setzen Sie den Wert auf.1Der Standardwert ist0. 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 zwischen0und1.00(100%) an. Dieser Wert wird außer Kraft gesetzt, wenn er angegebenXRAY_SAMPLING_RULE_MANIFESTwird. Diese Variable wird mit Envoy-Images der Versionv1.19.1.1-prod4 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-prodund 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 gesetzt
mesh/resourceName. Diese Variable wird in der Envoy-Image-Versionv1.23.1.0-prododer 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
ENABLE_ENVOY_DATADOG_TRACING-
Aktiviert die Datadog-Trace-Erfassung
127.0.0.1:8126als standardmäßigen Datadog-Agent-Endpunkt. Um dies zu aktivieren, setzen Sie den Wert auf1(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-meshNamevirtualNodeNameDiese Variable wird mit Envoy-Images der Versionv1.18.3.0-prod4 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 1.16.1.0-prod und höher unterstützt.
ENABLE_ENVOY_JAEGER_TRACING-
Aktiviert die Jaeger-Trace-Erfassung
127.0.0.1:9411als Standard-Jaeger-Endpunkt. Um dies zu aktivieren, setzen Sie den Wert auf1(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
JSONoder imPROTOkodierten Format benötigt. Standardmäßig wird dieser Wert auf gesetztPROTO. Diese Variable wird in der Envoy-Image-Versionv1.23.1.0-prododer 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.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_resourcesin derselben Tracing-Konfigurationsdatei konfigurieren. Zipkin hat beispielsweise eincollector_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 DogStats
ENABLE_ENVOY_DOG_STATSD-
Aktiviert DogStats D Stats
127.0.0.1:8125als 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 Version1.15.0oder 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:8125Wenn dieENVOY_STATS_SINKS_CFG_FILEVariable angegeben wird, die eine Stats-Sink-Konfiguration enthält, überschreibt sie alle D-Variablen. DogStats Diese Variable wird in der Envoy-Image-Versionv1.19.1.0-prododer 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_ARNals Envoy in Metriken und Traces auf sich selbst verweist. Sie können dieses Verhalten übergehen, indem Sie dieAPPMESH_RESOURCE_CLUSTER-Umgebungsvariable mit Ihrem eigenen Namen festlegen. Diese Variable kann nur mit einer Version1.15.0oder einer höheren Version des Envoy-Images verwendet werden. APPMESH_METRIC_EXTENSION_VERSION-
Stellen Sie den Wert auf ein,
1um 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,
1um 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 unsererIPv4Domain 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
ENABLE_ENVOY_STATS_TAGS-
Ermöglicht die Verwendung von in App Mesh definierten Tags
appmesh.meshundappmesh.virtual_node. Weitere Informationen finden Sie unter config.metrics.v3. TagSpecifierin der Envoy-Dokumentation. Um dies zu aktivieren, setzen Sie den Wert auf 1. 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. StatsSink
in 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.