Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Variabel konfigurasi utusan
**penting**
Pemberitahuan akhir dukungan: Pada 30 September 2026, AWS akan menghentikan dukungan untuk. AWS App Mesh Setelah 30 September 2026, Anda tidak lagi dapat mengakses AWS App Mesh konsol atau AWS App Mesh sumber daya. Untuk informasi lebih lanjut, kunjungi posting blog ini [Migrasi dari AWS App Mesh ke Amazon ECS Service Connect](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect).
Gunakan variabel lingkungan berikut untuk mengonfigurasi container Envoy untuk grup tugas node virtual App Mesh Anda.
**catatan**
**App Mesh Envoy 1.17 tidak mendukung API v2 xDs Envoy.** **Jika Anda menggunakan [variabel konfigurasi Envoy yang menerima file konfigurasi](https://docs.aws.amazon.com/app-mesh/latest/userguide/envoy-config.html) Envoy, mereka harus diperbarui ke API xDs v3 terbaru.**
## Variabel yang dibutuhkan
Variabel lingkungan berikut diperlukan untuk semua container App Mesh Envoy. Variabel ini hanya dapat digunakan dengan versi `1.15.0` atau yang lebih baru dari gambar Utusan. Jika Anda menggunakan versi gambar yang lebih lama, maka Anda harus mengatur `APPMESH_VIRTUAL_NODE_NAME` variabel sebagai gantinya.
`APPMESH_RESOURCE_ARN`
Saat Anda menambahkan wadah Envoy ke grup tugas, atur variabel lingkungan ini ke ARN dari node virtual atau gateway virtual yang diwakili oleh grup tugas. Daftar berikut berisi contoh ARNs:
+ **Node virtual** - arn:aws:appmesh: ::mesh//virtualNode/ *Region-code* *111122223333* *meshName* *virtualNodeName*
+ **Gerbang virtual** — arn:aws:appmesh: ::mesh//virtualGateway/ *Region-code* *111122223333* *meshName* *virtualGatewayName*
## Variabel opsional
Variabel lingkungan berikut adalah opsional untuk wadah App Mesh Envoy.
`ENVOY_LOG_LEVEL`
Menentukan tingkat log untuk wadah Utusan.
Nilai yang valid:`trace`,`debug`,`info`,`warn`,`error`,`critical`, `off`
Default: `info`
`ENVOY_INITIAL_FETCH_TIMEOUT`
Menentukan jumlah waktu Utusan menunggu respons konfigurasi pertama dari server manajemen selama proses inisialisasi.
Untuk informasi selengkapnya, lihat [Sumber konfigurasi di Dokumentasi](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) Utusan. Ketika diatur ke`0`, tidak ada batas waktu.
Default: `0`
`ENVOY_CONCURRENCY`
Menetapkan opsi baris `--concurrency` perintah saat memulai Utusan. Ini tidak diatur secara default. Opsi ini tersedia dari versi Utusan `v1.24.0.0-prod` atau di atasnya.
Untuk informasi selengkapnya, lihat [Opsi baris perintah di Dokumentasi](https://www.envoyproxy.io/docs/envoy/latest/operations/cli#cmdoption-concurrency) Utusan.
### Variabel admin
Gunakan variabel lingkungan ini untuk mengkonfigurasi antarmuka administratif Envoy.
`ENVOY_ADMIN_ACCESS_PORT`
Tentukan port admin khusus untuk didengarkan oleh Envoy. Default: `9901`.
Port admin Envoy harus berbeda dari port pendengar mana pun di gateway virtual atau node virtual
`ENVOY_ADMIN_ACCESS_LOG_FILE`
Tentukan jalur khusus untuk menulis log akses Utusan ke. Default: `/tmp/envoy_admin_access.log`.
`ENVOY_ADMIN_ACCESS_ENABLE_IPV6`
Beralih antarmuka administrasi Envoy untuk menerima `IPv6` lalu lintas, yang memungkinkan antarmuka ini menerima keduanya dan lalu lintas. `IPv4` `IPv6` Secara default flag ini disetel ke false, dan Envoy hanya mendengarkan lalu lintas. `IPv4` Variabel ini hanya dapat digunakan dengan Envoy image versi 1.22.0 atau yang lebih baru.
### Variabel agen
Gunakan variabel lingkungan ini untuk mengkonfigurasi AWS App Mesh Agen untuk Utusan. Untuk informasi selengkapnya, lihat [Agen App Mesh untuk Utusan](https://docs.aws.amazon.com//app-mesh/latest/userguide/appnet-agent.html).
`APPNET_ENVOY_RESTART_COUNT`
Menentukan berapa kali Agen memulai ulang proses proxy Envoy dalam tugas atau pod yang sedang berjalan jika keluar. Agen juga mencatat status keluar setiap kali Utusan keluar untuk memudahkan pemecahan masalah. Nilai default dari variabel ini adalah`0`. Ketika nilai default ditetapkan, Agen tidak mencoba untuk memulai ulang proses.
Default: `0`
Maksimum: `10`
`PID_POLL_INTERVAL_MS`
Menentukan interval dalam milidetik di mana status proses proxy Utusan diperiksa oleh Agen. Nilai default-nya adalah `100`.
Default: `100`
Minimal: `100`
Maksimum: `1000`
`LISTENER_DRAIN_WAIT_TIME_S`
Menentukan jumlah waktu dalam hitungan detik proxy Utusan menunggu koneksi aktif ditutup sebelum proses keluar.
Default: `20`
Minimal: `5`
Maksimum: `110`
`APPNET_AGENT_ADMIN_MODE`
Memulai server antarmuka manajemen Agen dan mengikatnya ke alamat tcp atau soket unix.
Nilai valid: `tcp`, `uds`
`APPNET_AGENT_HTTP_PORT`
Tentukan port yang akan digunakan untuk mengikat antarmuka manajemen Agen dalam `tcp` mode. Pastikan nilai port adalah> `1024` jika`uid`\$1 =`0`. Pastikan port kurang dari`65535`.
Default: `9902`
`APPNET_AGENT_ADMIN_UDS_PATH`
Tentukan jalur soket domain unix untuk antarmuka manajemen Agen dalam `uds` mode.
Default: `/var/run/ecs/appnet_admin.sock`
### Menelusuri variabel
Anda dapat mengonfigurasi tidak satu pun atau salah satu driver penelusuran berikut.
#### AWS X-Ray variabel
Gunakan variabel lingkungan berikut untuk mengonfigurasi App Mesh dengan AWS X-Ray. Lihat informasi selengkapnya di [Panduan Developer AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/).
`ENABLE_ENVOY_XRAY_TRACING`
Mengaktifkan penelusuran X-Ray menggunakan `127.0.0.1:2000` sebagai titik akhir daemon default. Untuk mengaktifkan, atur nilainya ke`1`. Nilai default-nya adalah `0`.
`XRAY_DAEMON_PORT`
Tentukan nilai port untuk mengganti port daemon X-Ray default:. `2000`
`XRAY_SAMPLING_RATE`
Tentukan laju pengambilan sampel untuk mengganti laju pengambilan sampel default pelacak X-Ray sebesar (5%). `0.05` Tentukan nilai sebagai desimal antara `0` dan `1.00` (100%). Nilai ini diganti jika `XRAY_SAMPLING_RULE_MANIFEST` ditentukan. Variabel ini didukung dengan gambar Envoy versi `v1.19.1.1-prod` dan yang lebih baru.
`XRAY_SAMPLING_RULE_MANIFEST`
Tentukan jalur file di sistem file wadah Envoy untuk mengonfigurasi aturan pengambilan sampel khusus yang dilokalkan untuk pelacak X-Ray. Untuk informasi selengkapnya, lihat [Aturan pengambilan sampel](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-go-configuration.html#xray-sdk-go-configuration-sampling) di *Panduan AWS X-Ray Pengembang*. Variabel ini didukung dengan gambar Envoy versi `v1.19.1.0-prod` dan yang lebih baru.
`XRAY_SEGMENT_NAME`
Tentukan nama segmen untuk jejak untuk mengganti nama segmen X-Ray default. Secara default nilai ini akan ditetapkan sebagai`mesh/resourceName`. Variabel ini didukung dengan versi gambar Envoy `v1.23.1.0-prod` atau yang lebih baru.
#### Variabel penelusuran datadog
Variabel lingkungan berikut membantu Anda mengonfigurasi App Mesh dengan pelacak agen Datadog. Untuk informasi selengkapnya, lihat [Konfigurasi Agen](https://docs.datadoghq.com/tracing/send_traces/) dalam dokumentasi Datadog.
`ENABLE_ENVOY_DATADOG_TRACING`
Mengaktifkan pengumpulan jejak Datadog menggunakan `127.0.0.1:8126` sebagai titik akhir agen Datadog default. Untuk mengaktifkan, atur nilainya ke `1` (nilai default adalah`0`).
`DATADOG_TRACER_PORT`
Tentukan nilai port untuk mengganti port agen Datadog default:. `8126`
`DATADOG_TRACER_ADDRESS`
Tentukan alamat IP untuk mengganti alamat agen Datadog default:. `127.0.0.1`
`DD_SERVICE`
Tentukan nama layanan untuk jejak untuk mengganti nama layanan Datadog default:/. `envoy-meshName` `virtualNodeName` Variabel ini didukung dengan gambar Envoy versi `v1.18.3.0-prod` dan yang lebih baru.
#### Variabel penelusuran Jaeger
Gunakan variabel lingkungan berikut untuk mengonfigurasi App Mesh dengan penelusuran Jaeger. Untuk informasi selengkapnya, lihat [Memulai](https://www.jaegertracing.io/docs/1.21/getting-started/) di dokumentasi Jaeger. Variabel-variabel ini didukung dengan gambar Envoy versi `1.16.1.0-prod` dan yang lebih baru.
`ENABLE_ENVOY_JAEGER_TRACING`
Mengaktifkan koleksi jejak Jaeger menggunakan `127.0.0.1:9411` sebagai titik akhir Jaeger default. Untuk mengaktifkan, atur nilainya ke `1` (nilai default adalah`0`).
`JAEGER_TRACER_PORT`
Tentukan nilai port untuk mengganti port Jaeger default:. `9411`
`JAEGER_TRACER_ADDRESS`
Tentukan alamat IP untuk mengganti alamat Jaeger default:. `127.0.0.1`
`JAEGER_TRACER_VERSION`
Tentukan apakah kolektor membutuhkan jejak dalam `JSON` atau format yang `PROTO` dikodekan. Secara default nilai ini akan diatur ke`PROTO`. Variabel ini didukung dengan versi gambar Envoy `v1.23.1.0-prod` atau yang lebih baru.
#### Variabel penelusuran utusan
Tetapkan variabel lingkungan berikut untuk menggunakan konfigurasi penelusuran Anda sendiri.
`ENVOY_TRACING_CFG_FILE`
Tentukan jalur file di sistem file wadah Utusan. Untuk informasi selengkapnya, lihat [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 dokumentasi Utusan.
Jika konfigurasi penelusuran memerlukan penentuan cluster penelusuran, pastikan untuk mengonfigurasi konfigurasi klaster terkait di bawah `static_resources` dalam file konfigurasi penelusuran yang sama. Misalnya, Zipkin memiliki [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)bidang untuk nama cluster yang menampung kolektor jejak, dan cluster itu perlu didefinisikan secara statis.
### DogStatsD variabel
Gunakan variabel lingkungan berikut untuk mengonfigurasi App Mesh dengan DogStats D. Untuk informasi lebih lanjut, lihat dokumentasi [DogStatsD](https://docs.datadoghq.com/developers/dogstatsd/).
`ENABLE_ENVOY_DOG_STATSD`
Mengaktifkan statistik DogStats D menggunakan `127.0.0.1:8125` sebagai titik akhir daemon default. Untuk mengaktifkan, atur nilainya ke`1`.
`STATSD_PORT`
Tentukan nilai port untuk mengganti port daemon DogStats D default.
`STATSD_ADDRESS`
Tentukan nilai alamat IP untuk mengganti alamat IP daemon DogStats D default. Default: `127.0.0.1`. Variabel ini hanya dapat digunakan dengan versi `1.15.0` atau yang lebih baru dari gambar Utusan.
`STATSD_SOCKET_PATH`
Tentukan soket domain unix untuk daemon DogStats D. Jika variabel ini tidak ditentukan dan DogStats D diaktifkan, maka nilai ini default ke port alamat IP daemon DogStats D dari. `127.0.0.1:8125` Jika `ENVOY_STATS_SINKS_CFG_FILE` variabel ditentukan berisi konfigurasi stats sink, itu mengesampingkan semua variabel D. DogStats Variabel ini didukung dengan versi gambar Envoy `v1.19.1.0-prod` atau yang lebih baru.
### Variabel App Mesh
Variabel berikut membantu Anda mengonfigurasi App Mesh.
`APPMESH_RESOURCE_CLUSTER`
Secara default, App Mesh menggunakan nama sumber daya yang Anda tentukan `APPMESH_RESOURCE_ARN` saat Envoy merujuk dirinya sendiri dalam metrik dan jejak. Anda dapat menimpa perilaku ini dengan mengatur variabel lingkungan `APPMESH_RESOURCE_CLUSTER` dengan nama Anda sendiri. Variabel ini hanya dapat digunakan dengan versi `1.15.0` atau yang lebih baru dari gambar Utusan.
`APPMESH_METRIC_EXTENSION_VERSION`
Tetapkan nilainya `1` untuk mengaktifkan ekstensi metrik App Mesh. Untuk informasi selengkapnya tentang menggunakan ekstensi metrik App Mesh, lihat[Ekstensi metrik untuk App Mesh](metrics.md).
`APPMESH_DUALSTACK_ENDPOINT`
Tetapkan nilai untuk terhubung `1` ke titik akhir App Mesh Dual Stack. Saat flag ini disetel, Envoy menggunakan domain berkemampuan tumpukan ganda kami. Secara default flag ini diatur ke false dan hanya terhubung ke `IPv4` domain kami. Variabel ini hanya dapat digunakan dengan Envoy image versi 1.22.0 atau yang lebih baru.
### Variabel statistik utusan
Gunakan variabel lingkungan berikut untuk mengonfigurasi App Mesh dengan Statistik Utusan. Untuk informasi selengkapnya, lihat dokumentasi [Statistik Utusan](https://www.envoyproxy.io/docs/envoy/v1.6.0/api-v2/config/metrics/v2/stats.proto).
`ENABLE_ENVOY_STATS_TAGS`
Mengaktifkan penggunaan tag yang ditentukan App Mesh `appmesh.mesh` dan`appmesh.virtual_node`. Untuk informasi selengkapnya, lihat [config.metrics.v3. TagSpecifier](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-tagspecifier)dalam dokumentasi Utusan. Untuk mengaktifkan, atur nilainya ke`1`.
`ENVOY_STATS_CONFIG_FILE`
Tentukan jalur file di sistem file kontainer Envoy untuk mengganti file konfigurasi tag Statistik default dengan file Anda sendiri. Untuk informasi selengkapnya, lihat [config.metrics.v3. StatsConfig](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-statsconfig).
Menyetel konfigurasi statistik khusus yang menyertakan filter statistik dapat menyebabkan Envoy memasuki status yang tidak lagi disinkronkan dengan benar dengan status App Mesh di dunia. Ini adalah [bug](https://github.com/envoyproxy/envoy/issues/9856) di Envoy. Rekomendasi kami adalah untuk tidak melakukan penyaringan statistik di Envoy. Jika pemfilteran mutlak diperlukan, kami telah mencantumkan beberapa solusi dalam [masalah](https://github.com/aws/aws-app-mesh-roadmap/issues/283) ini di peta jalan kami.
`ENVOY_STATS_SINKS_CFG_FILE`
Tentukan jalur file di sistem file kontainer Envoy untuk mengganti konfigurasi default dengan konfigurasi Anda sendiri. Untuk informasi selengkapnya, lihat [config.metrics.v3. StatsSink](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-statssink)dalam dokumentasi Utusan.
### Variabel usang
Variabel lingkungan `APPMESH_VIRTUAL_NODE_NAME` dan `APPMESH_RESOURCE_NAME` tidak lagi didukung dalam versi Envoy `1.15.0` atau yang lebih baru. Namun, mereka masih didukung untuk jerat yang ada. Alih-alih menggunakan variabel ini dengan versi Envoy `1.15.0` atau yang lebih baru, gunakan `APPMESH_RESOURCE_ARN` untuk semua titik akhir App Mesh.