View a markdown version of this page

Variabili di configurazione Envoy - AWS App Mesh

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-code 111122223333 meshName virtualNodeName

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

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, off

Impostazione 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 --concurrency riga di comando durante l'avvio di Envoy. Questa opzione non è impostata di default. Questa opzione è disponibile a partire dalla versione Envoy v1.24.0.0-prod o 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 IPv6 traffico, il che consente a questa interfaccia di accettare sia 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 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: 0

Massimo: 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: 100

Minimo: 100

Massimo: 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: 20

Minimo: 5

Massimo: 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à. tcp Assicuratevi che il valore della porta sia > 1024 ifuid! =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 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 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:2000 come endpoint daemon predefinito. Per abilitare, imposta il valore su. 1 Il 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.05 Specificate il valore come decimale compreso tra 0 e (100%). 1.00 Questo valore viene sovrascritto se XRAY_SAMPLING_RULE_MANIFEST viene 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-prod e 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 comemesh/resourceName. Questa variabile è supportata nella versione dell'immagine di Envoy v1.23.1.0-prod o 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 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

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-meshName virtualNodeName Questa 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 nella documentazione di Jaeger. Queste variabili sono supportate con le immagini 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 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 formatoJSON. PROTO Per impostazione predefinita, questo valore sarà impostato su. PROTO Questa variabile è supportata nella 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 un percorso di file nel file system del contenitore Envoy. Per ulteriori informazioni, consulta la documentazione config.trace.v3.Tracing di Envoy.

Nota

Se la configurazione di tracing richiede la specificazione di un cluster di tracing, assicurati di configurare la configurazione del cluster associato static_resources nello stesso file di configurazione di tracing. Ad esempio, Zipkin ha un collector_cluster 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 DogStats D.

ENABLE_ENVOY_DOG_STATSD

Abilita le statistiche DogStats D utilizzando 127.0.0.1:8125 come 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 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, per impostazione predefinita questo valore è la porta dell'indirizzo IP del demone DogStats D di. 127.0.0.1:8125 Se viene specificata una ENVOY_STATS_SINKS_CFG_FILE variabile 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_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 una 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

APPMESH_DUALSTACK_ENDPOINT

Imposta il valore su per connetterti 1 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 IPv4 dominio. 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.mesh definiti da App Mesh e. appmesh.virtual_node Per 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. StatsSinknella 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.