Variabili di configurazione di Envoy - AWS App Mesh
Variabili obbligatorieVariabili opzionali

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 sarà più possibile 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 gli XD v2 di Envoy. API Se utilizzi variabili di configurazione Envoy che accettano i file di configurazione di Envoy, devono essere aggiornate agli XD v3 più recenti. API

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 ARN di ambiente sul nodo virtuale o sul gateway virtuale rappresentato dal gruppo di attività. L'elenco seguente contiene esempi: ARNs

  • Nodo virtuale — arn:aws:appmesh:Region-code:111122223333:mesh/meshName/virtualNode/virtualNodeName

  • Gateway virtuale — arn:aws:appmesh:Region-code:111122223333:mesh/meshName/virtualGateway/virtualGatewayName

Quando si utilizza l'App Mesh Preview Channel, ARNs è necessario utilizzare il us-west-2 Regione e utilizzoappmesh-preview, anzichéappmesh. Ad esempio, il valore ARN di un nodo virtuale nell'App Mesh Preview Channel èarn:aws:appmesh-preview:us-west-2:111122223333:mesh/meshName/virtualNode/virtualNodeName.

Variabili opzionali

La seguente variabile di ambiente è facoltativa per i contenitori App Mesh Envoy.

ENVOY_LOG_LEVEL

Speciifica 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 nella documentazione di Envoy. Quando è impostato su0, non c'è alcun timeout.

Impostazione predefinita: 0

ENVOY_CONCURRENCY

Imposta l'opzione della --concurrency riga di comando all'avvio di Envoy. Questo non è impostato 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 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.

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

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.

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 ifuid! =0. Assicurati che la porta sia inferiore a65535.

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.

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 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 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 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 config.trace.v3.Tracingdi Envoy.

Nota

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 collector_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 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 di Envoy o successiva. v1.19.1.0-prod

Variabili App Mesh

Le seguenti variabili consentono di configurare App Mesh.

APPMESH_PREVIEW

Imposta il valore su per 1 connetterti all'endpoint App Mesh Preview Channel. Per ulteriori informazioni sull'utilizzo dell'App Mesh Preview Channel, consultaCanale di anteprima 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, consultaEstensione delle metriche per App Mesh.

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 Stats.

ENABLE_ENVOY_STATS_TAGS

Abilita l'uso di tag definiti da App Mesh appmesh.mesh eappmesh.virtual_node. Per ulteriori informazioni, consulta 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, vedete config.metrics.v3. StatsConfig.

Nota

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 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.

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. StatsSinknella 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.