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 können Sie nicht mehr auf die AWS App Mesh Konsole oder die Ressourcen zugreifen. AWS App Mesh Weitere Informationen finden Sie in diesem Blogbeitrag [Migration von AWS App Mesh zu Amazon ECS Service Connect](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect).
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](https://docs.aws.amazon.com/app-mesh/latest/userguide/envoy-config.html) 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 ein 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 unter [Konfigurationsquellen](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) in der Envoy-Dokumentation. Wenn auf `0` eingestellt, 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](https://www.envoyproxy.io/docs/envoy/latest/operations/cli#cmdoption-concurrency) 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`.
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](https://docs.aws.amazon.com//app-mesh/latest/userguide/appnet-agent.html).
`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 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 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 ist`uid`\! =`0`. Stellen Sie sicher, dass der Port kleiner ist als`65535`.
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](https://docs.aws.amazon.com/xray/latest/devguide/).
`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](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-go-configuration.html#xray-sdk-go-configuration-sampling) 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 gesetzt`mesh/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](https://docs.datadoghq.com/tracing/send_traces/) 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](https://www.jaegertracing.io/docs/1.21/getting-started/) 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 ist`0`).
`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 gesetzt`PROTO`. 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 [https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/trace/v3/http_tracer.proto#envoy-v3-api-msg-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)in der Envoy-Dokumentation.
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 [https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/trace/v3/zipkin.proto#config-trace-v3-zipkinconfig](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/trace/v3/zipkin.proto#config-trace-v3-zipkinconfig)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 [DogStatsD-Dokumentation](https://docs.datadoghq.com/developers/dogstatsd/).
`ENABLE_ENVOY_DOG_STATSD`
Aktiviert DogStats D-Statistiken, die `127.0.0.1:8125` als Standard-Daemon-Endpunkt verwendet werden. Um zu aktivieren, setzen Sie den Wert auf`1`.
`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_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 unter[Metrics-Erweiterung für App Mesh](metrics.md).
`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](https://www.envoyproxy.io/docs/envoy/v1.6.0/api-v2/config/metrics/v2/stats.proto).
`ENABLE_ENVOY_STATS_TAGS`
Ermöglicht die Verwendung von App Mesh Mesh-definierten Tags `appmesh.mesh` und`appmesh.virtual_node`. Weitere Informationen finden Sie unter [config.metrics.v3. TagSpecifier](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-tagspecifier)in der Envoy-Dokumentation. Um zu aktivieren, setzen Sie den Wert auf`1`.
`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](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-statsconfig).
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](https://github.com/envoyproxy/envoy/issues/9856) in Envoy. Wir empfehlen, in Envoy keine Statistiken zu filtern. Wenn eine Filterung unbedingt erforderlich ist, haben wir in dieser [Ausgabe](https://github.com/aws/aws-app-mesh-roadmap/issues/283) 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. StatsSink](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#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 Mesh-Endpunkte.