Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Variabili di configurazione di Envoy
**Importante**
Avviso di fine del supporto: il 30 settembre 2026, AWS verrà interrotto il supporto per. AWS App Mesh Dopo il 30 settembre 2026, non potrai più accedere alla AWS App Mesh console o alle risorse. AWS App Mesh Per ulteriori informazioni, consulta questo post di blog [Migrazione AWS App Mesh da Amazon ECS Service Connect.](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect)
Utilizza le seguenti variabili di ambiente per configurare i contenitori Envoy per i gruppi di attività del nodo virtuale App Mesh.
**Nota**
**App Mesh Envoy 1.17 non supporta l'API xDS v2 di Envoy.** **Se utilizzi [variabili di configurazione Envoy che accettano i file di configurazione](https://docs.aws.amazon.com/app-mesh/latest/userguide/envoy-config.html) di Envoy, devono essere aggiornate all'ultima API xDs v3.**
## Variabili obbligatorie
La seguente variabile di ambiente è richiesta per tutti i contenitori App Mesh Envoy. Questa variabile può essere utilizzata solo con la versione `1.15.0` o successiva dell'immagine Envoy. Se stai usando una versione precedente dell'immagine, devi invece impostare la `APPMESH_VIRTUAL_NODE_NAME` variabile.
`APPMESH_RESOURCE_ARN`
Quando aggiungi il contenitore Envoy a un gruppo di attività, imposta questa variabile di ambiente sull'ARN del nodo virtuale o del gateway virtuale rappresentato dal gruppo di attività. L'elenco seguente contiene esempi: ARNs
+ **Nodo virtuale**: arn:aws:appmesh: :mesh/ /VirtualNode/ {{Region-code}} {{111122223333}} {{meshName}} {{virtualNodeName}}
+ **Gateway virtuale** — arn:aws:appmesh: {{Region-code}} ::mesh/ /VirtualGateway/ {{111122223333}} {{meshName}} {{virtualGatewayName}}
## Variabili opzionali
La seguente variabile di ambiente è facoltativa per i contenitori App Mesh Envoy.
`ENVOY_LOG_LEVEL`
Specifica il livello di registro per il contenitore Envoy.
Valori validi: `trace`, `debug`, `info`, `warn`, `error`, `critical`, `off`
Impostazione predefinita: `info`
`ENVOY_INITIAL_FETCH_TIMEOUT`
Speciifica il periodo di attesa da parte di Envoy per la prima risposta di configurazione dal server di gestione durante il processo di inizializzazione.
Per ulteriori informazioni, vedere Fonti di [configurazione](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) nella documentazione di Envoy. Se il parametro è impostato su `0`, non è previsto alcun timeout.
Impostazione predefinita: `0`
`ENVOY_CONCURRENCY`
Imposta l'opzione della `--concurrency` riga di comando all'avvio di Envoy. Questa opzione non è impostata di default. Questa opzione è disponibile dalla versione Envoy `v1.24.0.0-prod` o successiva.
Per ulteriori informazioni, vedere [Opzioni della riga di comando nella documentazione](https://www.envoyproxy.io/docs/envoy/latest/operations/cli#cmdoption-concurrency) di Envoy.
### Variabili di amministrazione
Usa queste variabili di ambiente per configurare l'interfaccia amministrativa di Envoy.
`ENVOY_ADMIN_ACCESS_PORT`
Specificate una porta di amministrazione personalizzata su cui Envoy possa ascoltare. Default: `9901`.
La porta di amministrazione di Envoy deve essere diversa da qualsiasi porta listener sul gateway virtuale o sul nodo virtuale
`ENVOY_ADMIN_ACCESS_LOG_FILE`
Specificate un percorso personalizzato su cui scrivere i log di accesso di Envoy. Default: `/tmp/envoy_admin_access.log`.
`ENVOY_ADMIN_ACCESS_ENABLE_IPV6`
Attiva l'interfaccia di amministrazione di Envoy per accettare il traffico, il che consente a questa interfaccia di accettare sia `IPv6` il traffico che il traffico. `IPv4` `IPv6` Per impostazione predefinita, questo flag è impostato su false e Envoy ascolta solo il traffico. `IPv4` Questa variabile può essere utilizzata solo con la versione 1.22.0 o successiva dell'immagine di Envoy.
### Variabili dell'agente
Utilizzate queste variabili di ambiente per configurare l' AWS App Mesh Agent for Envoy. Per ulteriori informazioni, consulta App Mesh [Agent for Envoy](https://docs.aws.amazon.com//app-mesh/latest/userguide/appnet-agent.html).
`APPNET_ENVOY_RESTART_COUNT`
Speciifica il numero di volte in cui l'agente riavvia il processo proxy Envoy all'interno di un'attività o di un pod in esecuzione, se viene chiuso. L'agente registra inoltre lo stato di uscita ogni volta che Envoy esce per facilitare la risoluzione dei problemi. Il valore predefinito di questa variabile è `0`. Quando viene impostato il valore predefinito, l'agente non tenta di riavviare il processo.
Impostazione predefinita: `0`
Massimo: `10`
`PID_POLL_INTERVAL_MS`
Speciifica l'intervallo in millisecondi in cui lo stato del processo del proxy Envoy viene verificato dall'agente. Il valore predefinito è `100`.
Impostazione predefinita: `100`
Minimo: `100`
Massimo: `1000`
`LISTENER_DRAIN_WAIT_TIME_S`
Speciifica il periodo di tempo in secondi in cui il proxy Envoy attende la chiusura delle connessioni attive prima della chiusura del processo.
Impostazione predefinita: `20`
Minimo: `5`
Massimo: `110`
`APPNET_AGENT_ADMIN_MODE`
Avvia il server dell'interfaccia di gestione di Agent e lo associa a un indirizzo tcp o a un socket unix.
Valori validi: `tcp`, `uds`
`APPNET_AGENT_HTTP_PORT`
Specificare una porta da utilizzare per associare l'interfaccia di gestione di Agent in modalità. `tcp` Assicurati che il valore della porta sia > `1024` if`uid`\! =`0`. Assicurati che la porta sia inferiore a`65535`.
Impostazione predefinita: `9902`
`APPNET_AGENT_ADMIN_UDS_PATH`
Specificare il percorso del socket del dominio unix per l'interfaccia di gestione dell'agente in `uds` modalità.
Impostazione predefinita: `/var/run/ecs/appnet_admin.sock`
### Variabili di tracciamento
È possibile configurare nessuno o uno dei seguenti driver di tracciamento.
#### AWS X-Ray variabili
Usa le seguenti variabili di ambiente per configurare App Mesh con AWS X-Ray. Per ulteriori informazioni, consulta la [Guida per gli sviluppatori di AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/).
`ENABLE_ENVOY_XRAY_TRACING`
Abilita il tracciamento a raggi X utilizzando `127.0.0.1:2000` come endpoint demone predefinito. Per abilitare, imposta il valore su. `1` Il valore predefinito è `0`.
`XRAY_DAEMON_PORT`
Specificate un valore di porta per sovrascrivere la porta demone X-Ray predefinita:. `2000`
`XRAY_SAMPLING_RATE`
Specificate una frequenza di campionamento per sostituire la frequenza di campionamento predefinita del tracciante X-Ray (5%). `0.05` Specificate il valore come valore decimale compreso tra e (100%). `0` `1.00` Questo valore viene sovrascritto se specificato. `XRAY_SAMPLING_RULE_MANIFEST` Questa variabile è supportata con le immagini di Envoy della versione e successive. `v1.19.1.1-prod`
`XRAY_SAMPLING_RULE_MANIFEST`
Specificate un percorso del file nel file system del contenitore Envoy per configurare le regole di campionamento personalizzate localizzate per il tracciante X-Ray. *Per ulteriori informazioni, consulta le regole di [campionamento](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-go-configuration.html#xray-sdk-go-configuration-sampling) nella Guida per gli sviluppatori.AWS X-Ray * Questa variabile è supportata con le immagini di Envoy della versione `v1.19.1.0-prod` e successive.
`XRAY_SEGMENT_NAME`
Specificate un nome di segmento per le tracce per sovrascrivere il nome predefinito del segmento X-Ray. Per impostazione predefinita, questo valore sarà impostato come. `mesh/resourceName` Questa variabile è supportata con la versione dell'immagine di Envoy `v1.23.1.0-prod` o successiva.
#### Variabili di tracciamento Datadog
Le seguenti variabili di ambiente ti aiutano a configurare App Mesh con l'agent tracer Datadog. Per ulteriori informazioni, consulta [Agent Configuration](https://docs.datadoghq.com/tracing/send_traces/) nella documentazione di Datadog.
`ENABLE_ENVOY_DATADOG_TRACING`
Abilita la raccolta di tracce Datadog utilizzando `127.0.0.1:8126` come endpoint predefinito dell'agente Datadog. Per abilitare, imposta il valore su (il valore predefinito è`1`). `0`
`DATADOG_TRACER_PORT`
Specificate un valore di porta per sovrascrivere la porta predefinita dell'agente Datadog:. `8126`
`DATADOG_TRACER_ADDRESS`
Specificare un indirizzo IP per sovrascrivere l'indirizzo predefinito dell'agente Datadog:. `127.0.0.1`
`DD_SERVICE`
Specificate un nome di servizio per le tracce per sovrascrivere il nome di servizio Datadog predefinito:/. `envoy-meshName` `virtualNodeName` Questa variabile è supportata con le immagini di Envoy della versione e successive. `v1.18.3.0-prod`
#### Variabili di tracciamento Jaeger
Usa le seguenti variabili di ambiente per configurare App Mesh con Jaeger tracing. Per ulteriori informazioni, consulta [Getting Started nella documentazione](https://www.jaegertracing.io/docs/1.21/getting-started/) di Jaeger. Queste variabili sono supportate con le immagini di Envoy della versione e successive. `1.16.1.0-prod`
`ENABLE_ENVOY_JAEGER_TRACING`
Abilita la raccolta di tracce Jaeger utilizzando `127.0.0.1:9411` come endpoint Jaeger predefinito. Per abilitarla, impostate il valore su `1` (il valore predefinito è). `0`
`JAEGER_TRACER_PORT`
Specificate un valore di porta per sovrascrivere la porta Jaeger predefinita:. `9411`
`JAEGER_TRACER_ADDRESS`
Specificate un indirizzo IP per sostituire l'indirizzo Jaeger predefinito:. `127.0.0.1`
`JAEGER_TRACER_VERSION`
Specificate se il raccoglitore necessita di tracce in `JSON` formato codificato. `PROTO` Per impostazione predefinita, questo valore sarà impostato su. `PROTO` Questa variabile è supportata con la versione dell'immagine di Envoy `v1.23.1.0-prod` o successiva.
#### Variabile di tracciamento Envoy
Imposta la seguente variabile di ambiente per utilizzare la tua configurazione di tracciamento.
`ENVOY_TRACING_CFG_FILE`
Specificate il percorso del file nel file system del contenitore Envoy. Per ulteriori informazioni, consulta la documentazione [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)di Envoy.
Se la configurazione di tracciamento richiede la specifica di un cluster di tracciamento, assicurati di configurare la configurazione del cluster associata `static_resources` nello stesso file di configurazione di tracciamento. Ad esempio, Zipkin ha un [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)campo per il nome del cluster che ospita i raccoglitori di tracce e quel cluster deve essere definito staticamente.
### DogStatsVariabili D
Usa le seguenti variabili di ambiente per configurare App Mesh con DogStats D. Per ulteriori informazioni, consulta la documentazione [DogStatsD.](https://docs.datadoghq.com/developers/dogstatsd/)
`ENABLE_ENVOY_DOG_STATSD`
Abilita le statistiche DogStats D utilizzando `127.0.0.1:8125` come endpoint demone predefinito. Per abilitare, imposta il valore su. `1`
`STATSD_PORT`
Specificate un valore di porta per sostituire la porta demone DogStats D predefinita.
`STATSD_ADDRESS`
Specificare un valore di indirizzo IP per sovrascrivere l'indirizzo IP del demone DogStats D predefinito. Default: `127.0.0.1`. Questa variabile può essere utilizzata solo con la versione `1.15.0` o successiva dell'immagine Envoy.
`STATSD_SOCKET_PATH`
Specificate un socket di dominio unix per il demone D. DogStats Se questa variabile non è specificata e DogStats D è abilitato, il valore predefinito è la porta dell'indirizzo IP del demone DogStats D di. `127.0.0.1:8125` Se la `ENVOY_STATS_SINKS_CFG_FILE` variabile viene specificata contenente una configurazione stats sinks, sostituisce tutte le variabili D. DogStats Questa variabile è supportata con la versione dell'immagine Envoy o successiva. `v1.19.1.0-prod`
### Variabili App Mesh
Le seguenti variabili consentono di configurare App Mesh.
`APPMESH_RESOURCE_CLUSTER`
Per impostazione predefinita, App Mesh utilizza il nome della risorsa specificato in `APPMESH_RESOURCE_ARN` quando Envoy si riferisce a se stesso nelle metriche e nelle tracce. È possibile ignorare questo comportamento impostando la variabile di ambiente `APPMESH_RESOURCE_CLUSTER` con il proprio nome. Questa variabile può essere utilizzata solo con la versione `1.15.0` o successiva dell'immagine Envoy.
`APPMESH_METRIC_EXTENSION_VERSION`
Imposta il valore su per `1` abilitare l'estensione delle metriche App Mesh. Per ulteriori informazioni sull'utilizzo dell'estensione delle metriche App Mesh, consulta[Estensione delle metriche per App Mesh](metrics.md).
`APPMESH_DUALSTACK_ENDPOINT`
Imposta il valore su per `1` connetterti all'endpoint App Mesh Dual Stack. Quando questo flag è impostato, Envoy utilizza il nostro dominio con funzionalità dual stack. Per impostazione predefinita, questo flag è impostato su false e si connette solo al nostro dominio. `IPv4` Questa variabile può essere utilizzata solo con Envoy image versione 1.22.0 o successiva.
### Variabili di stato di Envoy
Usa le seguenti variabili di ambiente per configurare App Mesh con Envoy Stats. Per ulteriori informazioni, consulta la documentazione di [Envoy](https://www.envoyproxy.io/docs/envoy/v1.6.0/api-v2/config/metrics/v2/stats.proto) Stats.
`ENABLE_ENVOY_STATS_TAGS`
Abilita l'uso di tag definiti da App Mesh `appmesh.mesh` e`appmesh.virtual_node`. Per ulteriori informazioni, consulta [config.metrics.v3. TagSpecifier](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-tagspecifier)nella documentazione di Envoy. Per abilitare, imposta il valore su. `1`
`ENVOY_STATS_CONFIG_FILE`
Specificate un percorso di file nel file system del contenitore Envoy per sostituire il file di configurazione dei tag Stats predefinito con il vostro. [Per ulteriori informazioni, vedete config.metrics.v3. StatsConfig](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-statsconfig).
L'impostazione di una configurazione personalizzata delle statistiche che includa i filtri delle statistiche potrebbe portare Envoy a entrare in uno stato in cui non si sincronizzerà più correttamente con lo stato mondiale dell'App Mesh. Questo è un [bug](https://github.com/envoyproxy/envoy/issues/9856) di Envoy. La nostra raccomandazione è di non eseguire alcun filtraggio delle statistiche in Envoy. [Se il filtraggio è assolutamente necessario, abbiamo elencato un paio di soluzioni alternative in questo numero sulla nostra tabella di marcia.](https://github.com/aws/aws-app-mesh-roadmap/issues/283)
`ENVOY_STATS_SINKS_CFG_FILE`
Specificate un percorso di file nel file system del contenitore Envoy per sostituire la configurazione predefinita con la vostra. [Per ulteriori informazioni, vedete config.metrics.v3. StatsSink](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-statssink)nella documentazione di Envoy.
### Variabili obsolete
Le variabili di ambiente `APPMESH_VIRTUAL_NODE_NAME` e non `APPMESH_RESOURCE_NAME` sono più supportate nella versione di Envoy o successiva. `1.15.0` Tuttavia, sono ancora supportate per le mesh esistenti. Invece di utilizzare queste variabili con la versione di Envoy `1.15.0` o successiva, usale `APPMESH_RESOURCE_ARN` per tutti gli endpoint App Mesh.