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 Envoy
Importante
Avviso di fine del supporto: il 30 settembre 2026, AWS interromperà 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 del blog Migrazione da AWS App Mesh ad 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 di Envoy, devono essere aggiornate all'API xDS v3 più recente.
Variabili obbligatorie
La seguente variabile di ambiente è richiesta per tutti i contenitori App Mesh Envoy. Questa variabile può essere utilizzata solo con una 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 aggiungete il contenitore Envoy a un gruppo di attività, impostate questa variabile di ambiente sull'ARN del nodo virtuale o del gateway virtuale rappresentato dal gruppo di attività. L'elenco seguente contiene alcuni esempi di ARN:
-
Nodo virtuale — arn:aws:appmesh: ::mesh/ /VirtualNode/
Region-code111122223333meshNamevirtualNodeName -
Gateway virtuale — arn:aws:appmesh:
Region-code::mesh/ /VirtualGateway/111122223333meshNamevirtualGatewayName
-
Variabili opzionali
La seguente variabile di ambiente è opzionale 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,offImpostazione predefinita:
info ENVOY_INITIAL_FETCH_TIMEOUT-
Specifica il periodo di tempo in cui Envoy attende la prima risposta di configurazione dal server di gestione durante il processo di inizializzazione.
Per ulteriori informazioni, vedere Fonti di configurazione nella documentazione di Envoy.
Se il parametro è impostato su 0, non è previsto alcun timeout.Impostazione predefinita:
0 ENVOY_CONCURRENCY-
Imposta l'opzione della
--concurrencyriga di comando durante l'avvio di Envoy. Questa opzione non è impostata di default. Questa opzione è disponibile a partire dalla versione Envoyv1.24.0.0-prodo superiore.Per ulteriori informazioni, consulta Opzioni della riga di comando
nella documentazione di Envoy.
Variabili di amministrazione
Usa queste variabili di ambiente per configurare l'interfaccia amministrativa di Envoy.
ENVOY_ADMIN_ACCESS_PORT-
Specifica una porta di amministrazione personalizzata su cui Envoy possa ascoltare. Default:
9901.Nota
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-
Specifica un percorso personalizzato in 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 in modo che accetti il
IPv6traffico, il che consente a questa interfaccia di accettare sia il traffico che il traffico.IPv4IPv6Per impostazione predefinita, questo flag è impostato su false e Envoy ascolta solo il traffico.IPv4Questa variabile può essere utilizzata solo con Envoy image versione 1.22.0 o successiva.
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.
APPNET_ENVOY_RESTART_COUNT-
Specifica 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 è impostato il valore predefinito, l'agente non tenta di riavviare il processo.Impostazione predefinita:
0Massimo:
10 PID_POLL_INTERVAL_MS-
Specifica l'intervallo in millisecondi in cui lo stato del processo del proxy Envoy viene verificato dall'agente. Il valore predefinito è
100.Impostazione predefinita:
100Minimo:
100Massimo:
1000 LISTENER_DRAIN_WAIT_TIME_S-
Specifica il periodo di tempo in secondi in cui il proxy Envoy attende la chiusura delle connessioni attive prima della chiusura del processo.
Impostazione predefinita:
20Minimo:
5Massimo:
110 APPNET_AGENT_ADMIN_MODE-
Avvia il server di 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-
Specifica una porta da utilizzare per collegare l'interfaccia di gestione dell'agente in modalità.
tcpAssicuratevi che il valore della porta sia >1024ifuid! =0. Verificare che la porta sia inferiore a65535.Impostazione predefinita:
9902 APPNET_AGENT_ADMIN_UDS_PATH-
Specifica il percorso del socket di dominio unix per l'interfaccia di gestione dell'agente in
udsmodalità.Impostazione predefinita:
/var/run/ecs/appnet_admin.sock
Variabili di tracciamento
È possibile configurare nessuno o uno dei seguenti driver di tracciamento.
AWS X-Ray variables
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.
ENABLE_ENVOY_XRAY_TRACING-
Abilita X-Ray la traccia utilizzando
127.0.0.1:2000come endpoint daemon predefinito. Per abilitare, imposta il valore su.1Il valore predefinito è0. XRAY_DAEMON_PORT-
Specificate un valore di porta per sovrascrivere la porta X-Ray daemon predefinita:.
2000 XRAY_SAMPLING_RATE-
Specificate una frequenza di campionamento per sovrascrivere la frequenza di campionamento predefinita del X-Ray tracer (5%).
0.05Specificate il valore come decimale compreso tra0e (100%).1.00Questo valore viene sovrascritto seXRAY_SAMPLING_RULE_MANIFESTviene specificato. Questa variabile è supportata con le immagini Envoy della versione e successive.v1.19.1.1-prod XRAY_SAMPLING_RULE_MANIFEST-
Specificate un percorso di file nel file system del contenitore Envoy per configurare le regole di campionamento personalizzate localizzate per il tracciante. X-Ray Per ulteriori informazioni, consulta Regole di campionamento nella Guida per gli sviluppatori. AWS X-Ray Questa variabile è supportata con le immagini Envoy della versione
v1.19.1.0-prode successive. XRAY_SEGMENT_NAME-
Specificate un nome di segmento affinché le tracce sovrascrivano il nome del X-Ray segmento predefinito. Per impostazione predefinita, questo valore sarà impostato come
mesh/resourceName. Questa variabile è supportata nella versione dell'immagine di Envoyv1.23.1.0-prodo successiva.
Variabili di tracciamento Datadog
Le seguenti variabili di ambiente consentono di configurare App Mesh con l'agent tracer Datadog. Per ulteriori informazioni, vedere Agent Configuration
ENABLE_ENVOY_DATADOG_TRACING-
Abilita la raccolta di tracce Datadog utilizzando
127.0.0.1:8126come endpoint predefinito dell'agente Datadog. Per abilitare, imposta il valore su (il valore predefinito è1).0 DATADOG_TRACER_PORT-
Specifica un valore di porta per sovrascrivere la porta predefinita dell'agente Datadog:.
8126 DATADOG_TRACER_ADDRESS-
Specifica un indirizzo IP per sovrascrivere l'indirizzo predefinito dell'agente Datadog:.
127.0.0.1 DD_SERVICE-
Specifica un nome di servizio affinché le tracce sovrascrivano il nome del servizio Datadog predefinito:/.
envoy-meshNamevirtualNodeNameQuesta variabile è supportata con le immagini 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 Guida introduttiva 1.16.1.0-prod
ENABLE_ENVOY_JAEGER_TRACING-
Abilita la raccolta di tracce Jaeger utilizzando
127.0.0.1:9411come endpoint Jaeger predefinito. Per abilitare, imposta il valore su (il valore predefinito è1).0 JAEGER_TRACER_PORT-
Specifica un valore di porta per sovrascrivere la porta Jaeger predefinita:.
9411 JAEGER_TRACER_ADDRESS-
Specifica un indirizzo IP per sovrascrivere l'indirizzo Jaeger predefinito:.
127.0.0.1 JAEGER_TRACER_VERSION-
Specifica se il raccoglitore necessita di tracce in formato codificato o in formato
JSON.PROTOPer impostazione predefinita, questo valore sarà impostato su.PROTOQuesta variabile è supportata nella versione dell'immagine di Envoyv1.23.1.0-prodo successiva.
Variabile di tracciamento Envoy
Imposta la seguente variabile di ambiente per utilizzare la tua configurazione di tracciamento.
ENVOY_TRACING_CFG_FILE-
Specificate un percorso di file nel file system del contenitore Envoy. Per ulteriori informazioni, consulta la documentazione
config.trace.v3.Tracingdi Envoy. Nota
Se la configurazione di tracing richiede la specificazione di un cluster di tracing, assicurati di configurare la configurazione del cluster associato
static_resourcesnello stesso file di configurazione di tracing. Ad esempio, Zipkin ha uncollector_clustercampo 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
ENABLE_ENVOY_DOG_STATSD-
Abilita le statistiche DogStats D utilizzando
127.0.0.1:8125come endpoint daemon predefinito. Per abilitare, imposta il valore su.1 STATSD_PORT-
Specificate un valore di porta per sovrascrivere la porta del demone DogStats D predefinita.
STATSD_ADDRESS-
Specificate 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 una versione1.15.0o 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, per impostazione predefinita questo valore è la porta dell'indirizzo IP del demone DogStats D di.
127.0.0.1:8125Se viene specificata unaENVOY_STATS_SINKS_CFG_FILEvariabile contenente una configurazione stats sinks, sovrascrive tutte le variabili D. DogStats Questa variabile è supportata nella versione dell'immagine di Envoy o successiva.v1.19.1.0-prod
Variabili App Mesh
Le seguenti variabili aiutano a configurare App Mesh.
APPMESH_RESOURCE_CLUSTER-
Per impostazione predefinita, App Mesh utilizza il nome della risorsa specificata
APPMESH_RESOURCE_ARNquando Envoy si riferisce a se stesso nelle metriche e nelle tracce. È possibile ignorare questo comportamento impostando la variabile di ambienteAPPMESH_RESOURCE_CLUSTERcon il proprio nome. Questa variabile può essere utilizzata solo con una versione1.15.0o successiva dell'immagine Envoy. APPMESH_METRIC_EXTENSION_VERSION-
Imposta il valore su per
1abilitare l'estensione delle metriche App Mesh. Per ulteriori informazioni sull'utilizzo dell'estensione delle metriche App Mesh, consulta. Estensione delle metriche per App Mesh APPMESH_DUALSTACK_ENDPOINT-
Imposta il valore su per connetterti
1all'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 nostroIPv4dominio. Questa variabile può essere utilizzata solo con Envoy image versione 1.22.0 o successiva.
Variabili delle statistiche di Envoy
Usa le seguenti variabili di ambiente per configurare App Mesh con Envoy Stats. Per ulteriori informazioni, consulta la documentazione di Envoy Stats.
ENABLE_ENVOY_STATS_TAGS-
Consente l'uso di tag
appmesh.meshdefiniti da App Mesh e.appmesh.virtual_nodePer ulteriori informazioni, vedere config.metrics.v3. TagSpecifiernella 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, consulta config.metrics.v3. StatsConfig
. Nota
L'impostazione di una configurazione delle statistiche personalizzata che include filtri statistici potrebbe portare Envoy a entrare in uno stato in cui non si sincronizzerà più correttamente con lo stato del mondo di App Mesh. Si tratta di un bug in Envoy
. Il nostro consiglio è di non filtrare le statistiche in Envoy. Se il filtraggio è assolutamente necessario, abbiamo elencato un paio di soluzioni alternative in questo numero nella 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, consulta 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 Envoy o successiva. 1.15.0 Tuttavia, sono ancora supportate per le mesh esistenti. Invece di usare queste variabili con la versione Envoy 1.15.0 o successiva, usale APPMESH_RESOURCE_ARN per tutti gli endpoint di App Mesh.