Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# AWS X-Ray daemon
**catatan**
Pemberitahuan SDK/Daemon Pemeliharaan X-Ray - Pada 25 Februari 2026, AWS SDKs/Daemon X-Ray akan memasuki mode pemeliharaan, di mana AWS akan membatasi rilis X-Ray SDK dan Daemon untuk mengatasi masalah keamanan saja. Untuk informasi selengkapnya tentang garis waktu dukungan, lihat[Garis waktu Dukungan X-Ray SDK dan Daemon](xray-sdk-daemon-timeline.md). Kami merekomendasikan untuk bermigrasi ke OpenTelemetry. Untuk informasi lebih lanjut tentang migrasi ke OpenTelemetry, lihat [Migrasi dari instrumentasi X-Ray ke instrumentasi](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry
**catatan**
Anda sekarang dapat menggunakan CloudWatch agen untuk mengumpulkan metrik, log, dan jejak dari instans Amazon EC2 dan server di lokasi. CloudWatch agen versi 1.300025.0 dan yang lebih baru dapat mengumpulkan jejak dari atau klien [OpenTelemetry](xray-instrumenting-your-app.md#xray-instrumenting-opentel)X-Ray SDKs, dan mengirimkannya ke [X-Ray](xray-instrumenting-your-app.md#xray-instrumenting-xray-sdk). Menggunakan CloudWatch agen alih-alih AWS Distro for OpenTelemetry (ADOT) Collector atau daemon X-Ray untuk mengumpulkan jejak dapat membantu Anda mengurangi jumlah agen yang Anda kelola. Lihat topik [CloudWatch agen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html) di Panduan CloudWatch Pengguna untuk informasi selengkapnya.
AWS X-Ray Daemon adalah aplikasi perangkat lunak yang mendengarkan lalu lintas pada port UDP 2000, mengumpulkan data segmen mentah, dan menyampaikannya ke API. AWS X-Ray Daemon bekerja bersama dengan AWS X-Ray SDKs dan harus berjalan sehingga data yang dikirim oleh SDKs dapat mencapai layanan X-Ray. X-Ray Daemon adalah proyek sumber terbuka. Anda dapat mengikuti proyek dan mengirimkan masalah dan menarik permintaan di GitHub: [github. com/aws/aws](https://github.com/aws/aws-xray-daemon)-xray-daemon
AWS Lambda Aktif dan AWS Elastic Beanstalk, gunakan integrasi layanan tersebut dengan X-Ray untuk menjalankan daemon. Lambda menjalankan daemon secara otomatis setiap kali suatu fungsi dipanggil untuk permintaan sampel. Pada Elastic Beanstalk, [ gunakan `XRayEnabled` opsi konfigurasi ](xray-daemon-beanstalk.md) untuk menjalankan daemon pada instans di lingkungan Anda. Untuk informasi selengkapnya, silakan lihat
Untuk menjalankan daemon X-Ray secara lokal, lokal, atau lainnya Layanan AWS, unduh, [jalankan](#xray-daemon-running), lalu [berikan izin](#xray-daemon-permissions) untuk mengunggah dokumen segmen ke X-Ray.
## Mengunduh daemon
Anda dapat mengunduh daemon dari Amazon S3, Amazon ECR, atau Docker Hub, lalu menjalankannya secara lokal, atau menginstalnya di instans Amazon EC2 saat diluncurkan.
------
#### [ Amazon S3 ]
**Pemasang dan executable X-Ray daemon**
+ **Linux (dapat dieksekusi)** – [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-3.x.zip](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-3.x.zip) ([sig](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-3.x.zip.sig))
+ **Linux (penginstal RPM)** – [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.rpm](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.rpm)
+ **Linux (pemasang DEB)** – [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.deb](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.deb)
+ **Linux (ARM64, dapat dieksekusi)** [- [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-arm64-3.x.zip](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-arm64-3.x.zip)(sig)](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-arm64-3.x.zip.sig)
+ **Linux (ARM64, penginstal RPM)** - [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-arm64-3.x.rpm](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-arm64-3.x.rpm)
+ **Linux (ARM64, penginstal DEB)** - [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-arm64-3.x.deb](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-arm64-3.x.deb)
+ **OS X (dapat dieksekusi)** – [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-macos-3.x.zip](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-macos-3.x.zip) ([sig](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-macos-3.x.zip.sig))
+ **Windows (dapat dieksekusi)** – [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-windows-process-3.x.zip](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-windows-process-3.x.zip) ([sig](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-windows-process-3.x.zip.sig))
+ **Windows (layanan)** – [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-windows-service-3.x.zip](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-windows-service-3.x.zip) ([sig](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-windows-service-3.x.zip.sig))
Tautan ini selalu mengarah ke rilis 3.x terbaru daemon. Untuk mengunduh rilis tertentu, lakukan hal berikut:
+ Jika Anda ingin mengunduh rilis sebelum versi`3.3.0`, ganti `3.x` dengan nomor versi. Misalnya, `2.1.0`. Sebelum versi`3.3.0`, satu-satunya arsitektur yang tersedia adalah`arm64`. Misalnya, `2.1.0` dan `arm64`.
+ Jika Anda ingin mengunduh rilis demi versi`3.3.0`, ganti `3.x` dengan nomor versi dan `arch` dengan jenis arsitektur.
Aset X-Ray direplikasi ke bucket di setiap wilayah yang didukung. Untuk menggunakan bucket yang terdekat dengan Anda atau AWS sumber daya Anda, ganti wilayah di tautan di atas dengan wilayah Anda.
```
https://s3.us-west-2.amazonaws.com/aws-xray-assets.us-west-2/xray-daemon/aws-xray-daemon-3.x.rpm
```
------
#### [ Amazon ECR ]
Pada versi 3.2.0 daemon dapat ditemukan di [Amazon ECR](https://gallery.ecr.aws/xray/aws-xray-daemon). Sebelum menarik gambar, Anda harus [mengautentikasi klien docker Anda](https://docs.aws.amazon.com/AmazonECR/latest/public/public-registries.html#public-registry-auth) untuk registri publik Amazon ECR.
Tarik tanda versi 3.x terbaru yang dirilis dengan menjalankan perintah berikut:
```
docker pull public.ecr.aws/xray/aws-xray-daemon:3.x
```
Rilis sebelumnya atau alfa dapat diunduh dengan mengganti `3.x` dengan `alpha` atau nomor versi tertentu. Tidak disarankan untuk menggunakan citra daemon tanda tag alfa di lingkungan produksi.
------
#### [ Docker Hub ]
Daemon dapat ditemukan di [Hub Docker](https://hub.docker.com/r/amazon/aws-xray-daemon). Untuk mengunduh versi 3.x terbaru yang dirilis, jalankan perintah berikut:
```
docker pull amazon/aws-xray-daemon:3.x
```
Rilis daemon sebelumnya dapat dirilis dengan mengganti `3.x` dengan versi yang diinginkan.
------
## Memverifikasi tanda tangan arsip daemon
File tanda tangan GPG disertakan untuk aset daemon yang dikompresi dalam arsip ZIP. Kunci publik ada di sini: [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray.gpg](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray.gpg).
Anda dapat menggunakan kunci publik untuk memverifikasi bahwa arsip ZIP daemon adalah asli dan tidak dimodifikasi. Pertama, impor kunci publik dengan [GnuPG](https://gnupg.org/index.html).
**Untuk mengimpor kunci publik**
1. Unduh kunci publik.
```
$ BUCKETURL=https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2
$ wget $BUCKETURL/xray-daemon/aws-xray.gpg
```
1. Impor kunci publik ke dalam keyring Anda.
```
$ gpg --import aws-xray.gpg
gpg: /Users/me/.gnupg/trustdb.gpg: trustdb created
gpg: key 7BFE036BFE6157D3: public key "AWS X-Ray " imported
gpg: Total number processed: 1
gpg: imported: 1
```
Gunakan kunci yang diimpor untuk memverifikasi tanda tangan arsip ZIP daemon.
**Untuk memverifikasi tanda tangan arsip**
1. Unduh arsip dan file standar.
```
$ BUCKETURL=https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2
$ wget $BUCKETURL/xray-daemon/aws-xray-daemon-linux-3.x.zip
$ wget $BUCKETURL/xray-daemon/aws-xray-daemon-linux-3.x.zip.sig
```
1. Jalankan `gpg --verify` untuk memverifikasi tanda tangan.
```
$ gpg --verify aws-xray-daemon-linux-3.x.zip.sig aws-xray-daemon-linux-3.x.zip
gpg: Signature made Wed 19 Apr 2017 05:06:31 AM UTC using RSA key ID FE6157D3
gpg: Good signature from "AWS X-Ray "
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: EA6D 9271 FBF3 6990 277F 4B87 7BFE 036B FE61 57D3
```
Catat peringatan tentang kepercayaan. Kunci hanya dapat dipercaya jika Anda atau seseorang yang Anda percaya telah menandatanganinya. Ini tidak berarti bahwa tanda tangan tidak valid, hanya saja Anda belum memverifikasi kunci publik.
## Menjalankan daemon
Jalankan daemon secara lokal dari baris perintah. Gunakan `-o` pilihan untuk menjalankan dalam mode lokal, dan `-n` untuk mengatur wilayah.
```
~/Downloads$ ./xray -o -n us-east-2
```
Untuk petunjuk detail khusus platform, lihat topik berikut:
+ **Linux (lokal)** – [Menjalankan daemon X-Ray di Linux](xray-daemon-local.md#xray-daemon-local-linux)
+ **Windows (lokal)** – [Menjalankan Daemon X-Ray di Windows](xray-daemon-local.md#xray-daemon-local-windows)
+ **Elastic Beanstalk** – [Menjalankan daemon X-Ray AWS Elastic Beanstalk](xray-daemon-beanstalk.md)
+ **Amazon EC2** – [Menjalankan daemon X-Ray di Amazon EC2](xray-daemon-ec2.md)
+ **Amazon ECS** – [Menjalankan daemon X-Ray di Amazon ECS](xray-daemon-ecs.md)
Anda dapat menyesuaikan perilaku daemon lebih lanjut dengan menggunakan opsi baris perintah atau file konfigurasi. Lihat [Mengkonfigurasi daemon AWS X-Ray](xray-daemon-configuration.md) untuk detail.
## Memberikan izin kepada daemon untuk mengirim data ke X-Ray
Daemon X-Ray menggunakan AWS SDK untuk mengunggah data jejak ke X-Ray, dan memerlukan AWS kredensil dengan izin untuk melakukannya.
Di Amazon EC2, daemon menggunakan peran profil instans secara otomatis. [Untuk informasi tentang kredensil yang diperlukan untuk menjalankan daemon secara lokal, lihat menjalankan aplikasi Anda secara lokal.](security_iam_service-with-iam.md#xray-permissions-local)
Jika Anda menentukan kredensial di lebih dari satu lokasi (file kredensial, profil instans, atau variabel lingkungan), rantai penyedia SDK menentukan kredensial mana yang digunakan. Untuk informasi selengkapnya tentang memberikan kredensial ke SDK, lihat [Menentukan Kredenensial](https://aws.github.io/aws-sdk-go-v2/docs/configuring-sdk/#specifying-credentials) di *AWS Panduan Pengembang SDK for Go*.
IAM role atau pengguna IAM yang memiliki kredensial daemon harus memiliki izin untuk menulis data ke layanan atas nama Anda.
+ Untuk menggunakan daemon di Amazon EC2, buat peran profil instans baru atau tambahkan kebijakan terkelola ke yang sudah ada.
+ Untuk menggunakan daemon di Elastic Beanstalk, tambahkan kebijakan terkelola ke peran profil instans default Elastic Beanstalk.
+ Untuk menjalankan daemon secara lokal, lihat [menjalankan aplikasi Anda](security_iam_service-with-iam.md#xray-permissions-local) secara lokal.
Untuk informasi selengkapnya, lihat [Identitas dan manajemen akses untuk AWS X-Ray](security-iam.md).
## Log daemon X-Ray
Daemon mengeluarkan informasi tentang konfigurasi dan segmen saat ini yang dikirimkannya. AWS X-Ray
```
2016-11-24T06:07:06Z [Info] Initializing AWS X-Ray daemon 2.1.0
2016-11-24T06:07:06Z [Info] Using memory limit of 49 MB
2016-11-24T06:07:06Z [Info] 313 segment buffers allocated
2016-11-24T06:07:08Z [Info] Successfully sent batch of 1 segments (0.123 seconds)
2016-11-24T06:07:09Z [Info] Successfully sent batch of 1 segments (0.006 seconds)
```
Secara default, daemon mengeluarkan log ke STDOUT. Jika Anda menjalankan daemon di latar belakang, gunakan `--log-file` opsi baris perintah atau file konfigurasi untuk mengatur jalur berkas log. Anda juga dapat mengatur level log dan menonaktifkan rotasi log. Lihat [Mengkonfigurasi daemon AWS X-Ray](xray-daemon-configuration.md) untuk instruksi.
Di Elastic Beanstalk, platform menetapkan lokasi daemon log. Lihat [Menjalankan daemon X-Ray AWS Elastic Beanstalk](xray-daemon-beanstalk.md) untuk rincian selengkapnya.
# Mengkonfigurasi daemon AWS X-Ray
**catatan**
Pemberitahuan SDK/Daemon Pemeliharaan X-Ray - Pada 25 Februari 2026, AWS SDKs/Daemon X-Ray akan memasuki mode pemeliharaan, di mana AWS akan membatasi rilis X-Ray SDK dan Daemon untuk mengatasi masalah keamanan saja. Untuk informasi selengkapnya tentang garis waktu dukungan, lihat[Garis waktu Dukungan X-Ray SDK dan Daemon](xray-sdk-daemon-timeline.md). Kami merekomendasikan untuk bermigrasi ke OpenTelemetry. Untuk informasi lebih lanjut tentang migrasi ke OpenTelemetry, lihat [Migrasi dari instrumentasi X-Ray ke instrumentasi](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry
Anda dapat menggunakan opsi baris perintah atau file konfigurasi untuk menyesuaikan perilaku daemon X-Ray. Sebagian besar pilihan tersedia menggunakan kedua metode, tetapi beberapa hanya tersedia dalam file konfigurasi dan beberapa hanya pada baris perintah.
Untuk memulai, satu-satunya pilihan yang perlu Anda ketahui adalah `-n` atau `--region`, yang Anda gunakan untuk set wilayah yang digunakan daemon untuk mengirim pelacakan data ke X-Ray.
```
~/xray-daemon$ ./xray -n us-east-2
```
Jika Anda menjalankan daemon secara lokal, yaitu, bukan di Amazon EC2, Anda dapat menambahkan `-o` opsi untuk melewati pemeriksaan misalnya kredensi profil sehingga daemon akan siap lebih cepat.
```
~/xray-daemon$ ./xray -o -n us-east-2
```
Pilihan baris perintah lainnya memungkinkan Anda mengonfigurasi pencatatan, mendengarkan pada port yang berbeda, membatasi jumlah memori yang dapat digunakan daemon, atau mengambil peran untuk mengirim pelacakan data ke akun yang berbeda.
Anda dapat melewati file konfigurasi ke daemon untuk mengakses opsi konfigurasi lanjutan dan melakukan hal-hal seperti membatasi jumlah panggilan bersamaan ke X-Ray, menonaktifkan rotasi log, dan mengirim lalu lintas ke proksi.
**Topics**
+ [Variabel lingkungan yang didukung](#xray-daemon-configuration-variables)
+ [Menggunakan opsi baris perintah](#xray-daemon-configuration-commandline)
+ [Menggunakan file konfigurasi](#xray-daemon-configuration-configfile)
## Variabel lingkungan yang didukung
Daemon X-Ray mendukung variabel lingkungan berikut:
+ `AWS_REGION`— Menentukan titik [Wilayah AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html#cli-quick-configuration-region)akhir layanan X-Ray.
+ `HTTPS_PROXY` – Tentukan alamat proksi untuk daemon untuk mengunggah segmen melalui. Ini bisa berupa nama domain DNS atau alamat IP dan nomor port yang digunakan oleh server proksi Anda.
## Menggunakan opsi baris perintah
Lewati opsi ini ke daemon ketika Anda menjalankannya secara lokal atau dengan skrip data pengguna.
**Opsi Baris Perintah**
+ `-b`, `--bind` – Dengarkan dokumen segmen pada port UDP yang berbeda.
```
--bind "127.0.0.1:3000"
```
Default —`2000`.
+ `-t`, `--bind-tcp` – Dengarkan panggilan ke layanan X-Ray pada port TCP yang berbeda.
```
-bind-tcp "127.0.0.1:3000"
```
Default —`2000`.
+ `-c`, `--config` – Muat file konfigurasi dari jalur yang ditentukan.
```
--config "/home/ec2-user/xray-daemon.yaml"
```
+ `-f`, `--log-file` – Output log ke path file yang ditentukan.
```
--log-file "/var/log/xray-daemon.log"
```
+ `-l`, `--log-level` – Tingkat log, dari yang paling bertele-tele ke paling tidak: dev, debug, info, peringatan, kesalahan, prod.
```
--log-level warn
```
Default - `prod`
+ `-m`, `--buffer-memory` – Mengubah jumlah memori dalam MB yang buffer dapat menggunakan (minimal 3).
```
--buffer-memory 50
```
Default – 1% dari memori yang tersedia.
+ `-o`, `--local-mode` — Jangan periksa EC2 metadata misalnya.
+ `-r`, `--role-arn` – Asumsikan IAM role yang ditentukan untuk mengunggah segmen ke akun yang berbeda.
```
--role-arn "arn:aws:iam::123456789012:role/xray-cross-account"
```
+ `-a`, `--resource-arn` — Nama Sumber Daya Amazon (ARN) dari AWS sumber daya yang menjalankan daemon.
+ `-p`, `--proxy-address` — Unggah segmen ke AWS X-Ray melalui proxy. Protokol server proksi harus ditentukan.
```
--proxy-address "http://192.0.2.0:3000"
```
+ `-n`, `--region` – Kirim segmen ke layanan X-Ray di wilayah tertentu.
+ `-v`, `--version` — Tampilkan versi AWS X-Ray daemon.
+ `-h`, `--help` – Tampilkan layar bantuan.
## Menggunakan file konfigurasi
Anda juga dapat menggunakan file format YAML untuk mengonfigurasi daemon. Lewati file konfigurasi ke daemon dengan menggunakan `-c` Pilihan.
```
~$ ./xray -c ~/xray-daemon.yaml
```
**Opsi file konfigurasi**
+ `TotalBufferSizeMB` – Ukuran buffer maksimum dalam MB (minimal 3). Pilih 0 untuk menggunakan 1% dari memori host.
+ `Concurrency`— Jumlah maksimum panggilan bersamaan untuk AWS X-Ray mengunggah dokumen segmen.
+ `Region`— Kirim segmen ke AWS X-Ray layanan di wilayah tertentu.
+ `Socket` – Konfigurasi pengikatan daemon.
+ `UDPAddress` – Ubah port tempat daemon mendengarkan.
+ `TCPAddress` – Dengarkan [panggilan ke layanan X-Ray](xray-api-sampling.md) pada port TCP yang berbeda.
+ `Logging` – Konfigurasi perilaku pencatatan.
+ `LogRotation` – Set ke `false` untuk menonaktifkan rotasi log.
+ `LogLevel`— Ubah level log, dari yang paling bertele-tele menjadi paling sedikit:`dev`,,`debug`, `info` atau`prod`,`warn`,`error`. `prod` Secara default adalah `prod`, yang setara dengan `info`.
+ `LogPath` – Output log ke jalur file yang ditentukan.
+ `LocalMode`— Atur `true` untuk melewati pemeriksaan EC2 misalnya metadata.
+ `ResourceARN`— Nama Sumber Daya Amazon (ARN) dari AWS sumber daya yang menjalankan daemon.
+ `RoleARN` – Asumsikan IAM role yang ditentukan untuk mengunggah segmen ke akun yang berbeda.
+ `ProxyAddress`— Unggah segmen ke AWS X-Ray melalui proxy.
+ `Endpoint` – Ubah titik akhir layanan X-Ray untuk tempat daemon mengirimkan dokumen segmen.
+ `NoVerifySSL` – Nonaktifkan verifikasi sertifikat TLS.
+ `Version` – Versi format file konfigurasi daemon. Versi format file adalah **wajib** bidang.
**Example Xray-daemon.yaml**
File konfigurasi ini mengubah port mendengarkan daemon menjadi 3000, mematikan pemeriksaan metadata instans, set peran yang akan digunakan untuk mengunggah segmen, dan mengubah wilayah dan opsi pencatatan.
```
Socket:
UDPAddress: "127.0.0.1:3000"
TCPAddress: "127.0.0.1:3000"
Region: "us-west-2"
Logging:
LogLevel: "warn"
LogPath: "/var/log/xray-daemon.log"
LocalMode: true
RoleARN: "arn:aws:iam::123456789012:role/xray-cross-account"
Version: 2
```
# Menjalankan daemon X-Ray secara lokal
**catatan**
Pemberitahuan SDK/Daemon Pemeliharaan X-Ray - Pada 25 Februari 2026, AWS SDKs/Daemon X-Ray akan memasuki mode pemeliharaan, di mana AWS akan membatasi rilis X-Ray SDK dan Daemon untuk mengatasi masalah keamanan saja. Untuk informasi selengkapnya tentang garis waktu dukungan, lihat[Garis waktu Dukungan X-Ray SDK dan Daemon](xray-sdk-daemon-timeline.md). Kami merekomendasikan untuk bermigrasi ke OpenTelemetry. Untuk informasi lebih lanjut tentang migrasi ke OpenTelemetry, lihat [Migrasi dari instrumentasi X-Ray ke instrumentasi](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry
Anda dapat menjalankan AWS X-Ray daemon secara lokal di Linux, macOS, Windows, atau dalam wadah Docker. Jalankan daemon untuk menyampaikan data pelacakan ke X-Ray saat Anda mengembangkan dan menguji aplikasi Anda yang diinstrumentasi. Unduh dan ekstrak daemon dengan menggunakan petunjuk [di sini](xray-daemon.md#xray-daemon-downloading).
Saat berjalan secara lokal, daemon dapat membaca kredensional dari file kredensional AWS SDK (`.aws/credentials`di direktori pengguna Anda) atau dari variabel lingkungan. Untuk informasi selengkapnya, lihat [Memberikan izin kepada daemon untuk mengirim data ke X-Ray](xray-daemon.md#xray-daemon-permissions).
Daemon mendengarkan data UDP pada port 2000. Anda dapat mengubah port dan opsi lain dengan menggunakan file konfigurasi dan opsi baris perintah. Untuk informasi selengkapnya, lihat [Mengkonfigurasi daemon AWS X-Ray](xray-daemon-configuration.md).
## Menjalankan daemon X-Ray di Linux
Anda dapat menjalankan daemon yang dapat dieksekusi dari baris perintah. Gunakan opsi `-o` untuk menjalankan dalam mode lokal, dan `-n` untuk mengatur wilayah.
```
~/xray-daemon$ ./xray -o -n us-east-2
```
Untuk menjalankan daemon di latar belakang, gunakan `&`.
```
~/xray-daemon$ ./xray -o -n us-east-2 &
```
Hentikan proses daemon yang berjalan di latar belakang dengan `pkill`.
```
~$ pkill xray
```
## Menjalankan daemon X-Ray di kontainer Docker
Untuk menjalankan daemon secara lokal di kontainer Docker, simpan teks berikut ke file bernama `Dockerfile`. Unduh [contoh gambar](https://gallery.ecr.aws/xray/aws-xray-daemon) lengkap di Amazon ECR. Lihat [mengunduh daemon untuk informasi](xray-daemon.md#xray-daemon-downloading) lebih lanjut.
**Example Dockerfile – Amazon Linux**
```
FROM amazonlinux
RUN yum install -y unzip
RUN curl -o daemon.zip https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-3.x.zip
RUN unzip daemon.zip && cp xray /usr/bin/xray
ENTRYPOINT ["/usr/bin/xray", "-t", "0.0.0.0:2000", "-b", "0.0.0.0:2000"]
EXPOSE 2000/udp
EXPOSE 2000/tcp
```
Bangun citra kontainer dengan `docker build`.
```
~/xray-daemon$ docker build -t xray-daemon .
```
Jalankan citra dalam kontainer dengan `docker run`.
```
~/xray-daemon$ docker run \
--attach STDOUT \
-v ~/.aws/:/root/.aws/:ro \
--net=host \
-e AWS_REGION=us-east-2 \
--name xray-daemon \
-p 2000:2000/udp \
xray-daemon -o
```
Perintah ini menggunakan opsi berikut:
+ `--attach STDOUT` – Lihat output dari daemon di terminal.
+ `-v ~/.aws/:/root/.aws/:ro`— Berikan akses read-only container ke `.aws` direktori untuk membiarkannya membaca kredensil AWS SDK Anda.
+ `AWS_REGION=us-east-2` – Set variabel lingkungan `AWS_REGION` untuk memberitahu daemon wilayah yang akan digunakan.
+ `--net=host` – Lampirkan kontainer ke jaringan `host`. Kontainer pada jaringan host dapat berkomunikasi satu sama lain tanpa memublikasikan port.
+ `-p 2000:2000/udp` – Petakan UDP port 2000 pada mesin Anda ke port yang sama pada kontainer. Ini tidak diperlukan untuk kontainer di jaringan yang sama untuk berkomunikasi, tetapi memungkinkan Anda mengirim segmen ke daemon [dari baris perintah](xray-api-sendingdata.md#xray-api-daemon) atau dari aplikasi yang tidak berjalan di Docker.
+ `--name xray-daemon` – Namakan kontainer `xray-daemon` bukan menghasilkan nama acak.
+ `-o` (setelah nama citra) - Tambahkan opsi `-o` ke titik masuk yang menjalankan daemon dalam kontainer. Opsi ini memberi tahu daemon untuk berjalan dalam mode lokal untuk mencegahnya mencoba membaca metadata EC2 instance Amazon.
Untuk menghentikan daemon, gunakan `docker stop`. Jika Anda membuat perubahan pada `Dockerfile` dan membangun citra baru, Anda perlu menghapus kontainer yang sudah ada sebelum Anda dapat membuat kontainer lain dengan nama yang sama. Gunakan `docker rm` untuk menghapus kontainer.
```
$ docker stop xray-daemon
$ docker rm xray-daemon
```
## Menjalankan Daemon X-Ray di Windows
Anda dapat menjalankan daemon yang dapat dieksekusi dari baris perintah. Gunakan opsi `-o` untuk menjalankan dalam mode lokal, dan `-n` untuk mengatur wilayah.
```
> .\xray_windows.exe -o -n us-east-2
```
Gunakan PowerShell skrip untuk membuat dan menjalankan layanan untuk daemon.
**Example PowerShell skrip - Windows**
```
if ( Get-Service "AWSXRayDaemon" -ErrorAction SilentlyContinue ){
sc.exe stop AWSXRayDaemon
sc.exe delete AWSXRayDaemon
}
if ( Get-Item -path aws-xray-daemon -ErrorAction SilentlyContinue ) {
Remove-Item -Recurse -Force aws-xray-daemon
}
$currentLocation = Get-Location
$zipFileName = "aws-xray-daemon-windows-service-3.x.zip"
$zipPath = "$currentLocation\$zipFileName"
$destPath = "$currentLocation\aws-xray-daemon"
$daemonPath = "$destPath\xray.exe"
$daemonLogPath = "C:\inetpub\wwwroot\xray-daemon.log"
$url = "https://s3.dualstack.us-west-2.amazonaws.com/aws-xray-assets.us-west-2/xray-daemon/aws-xray-daemon-windows-service-3.x.zip"
Invoke-WebRequest -Uri $url -OutFile $zipPath
Add-Type -Assembly "System.IO.Compression.Filesystem"
[io.compression.zipfile]::ExtractToDirectory($zipPath, $destPath)
sc.exe create AWSXRayDaemon binPath= "$daemonPath -f $daemonLogPath"
sc.exe start AWSXRayDaemon
```
## Menjalankan daemon X-Ray di OS X
Anda dapat menjalankan daemon yang dapat dieksekusi dari baris perintah. Gunakan opsi `-o` untuk menjalankan dalam mode lokal, dan `-n` untuk mengatur wilayah.
```
~/xray-daemon$ ./xray_mac -o -n us-east-2
```
Untuk menjalankan daemon di latar belakang, gunakan `&`.
```
~/xray-daemon$ ./xray_mac -o -n us-east-2 &
```
Gunakan `nohup` untuk mencegah daemon berhenti ketika terminal ditutup.
```
~/xray-daemon$ nohup ./xray_mac &
```
# Menjalankan daemon X-Ray AWS Elastic Beanstalk
**catatan**
Pemberitahuan SDK/Daemon Pemeliharaan X-Ray - Pada 25 Februari 2026, AWS SDKs/Daemon X-Ray akan memasuki mode pemeliharaan, di mana AWS akan membatasi rilis X-Ray SDK dan Daemon untuk mengatasi masalah keamanan saja. Untuk informasi selengkapnya tentang garis waktu dukungan, lihat[Garis waktu Dukungan X-Ray SDK dan Daemon](xray-sdk-daemon-timeline.md). Kami merekomendasikan untuk bermigrasi ke OpenTelemetry. Untuk informasi lebih lanjut tentang migrasi ke OpenTelemetry, lihat [Migrasi dari instrumentasi X-Ray ke instrumentasi](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry
Untuk menyampaikan data pelacakan dari aplikasi Anda ke AWS X-Ray, Anda dapat menjalankan daemon X-Ray di instans Amazon EC2 lingkungan Elastic Beanstalk. Untuk daftar platform yang didukung, lihat [Mengonfigurasi AWS X-Ray Debugging](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/environment-configuration-debugging.html) di *AWS Elastic Beanstalk Panduan Developer*.
**catatan**
Daemon tersebut menggunakan profil instans lingkungan Anda untuk izin. Untuk petunjuk tentang penambahan izin ke profil instans Elastic Beanstalk, lihat [Memberikan izin kepada daemon untuk mengirim data ke X-Ray](xray-daemon.md#xray-daemon-permissions).
Platform Elastic Beanstalk menyediakan opsi konfigurasi yang dapat Anda atur untuk menjalankan daemon secara otomatis. Anda dapat mengaktifkan daemon dalam file konfigurasi dalam kode sumber Anda atau dengan memilih opsi di konsol Elastic Beanstalk. Bila Anda mengaktifkan opsi konfigurasi, daemon diinstal pada instans dan berjalan sebagai layanan.
Versi yang disertakan pada platform Elastic Beanstalk mungkin bukan versi terbaru. Lihat [Platform yang didukung topik](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/concepts.platforms.html) untuk mengetahui versi daemon yang tersedia untuk konfigurasi platform Anda.
Elastic Beanstalk tidak menyediakan X-Ray daemon pada platform Multicontainer Docker (Amazon ECS).
## Menggunakan integrasi X-Ray Elastic Beanstalk untuk menjalankan X-Ray daemon
Gunakan konsol tersebut untuk mengaktifkan integrasi X-Ray, atau konfigurasikan di kode sumber aplikasi Anda dengan file konfigurasi.
**Untuk mengaktifkan X-Ray daemon di konsol Elastic Beanstalk**
1. Buka [konsol Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk).
1. Arahkan ke [konsol manajemen](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/environments-console.html) untuk lingkungan Anda.
1. Pilih **Konfigurasi**.
1. Pilih **Pengaturan Perangkat Lunak**.
1. Untuk **X-Ray daemon**, pilih **Diaktifkan**.
1. Pilih **Terapkan**.
Anda dapat menyertakan file konfigurasi dalam kode sumber Anda untuk membuat konfigurasi portabel antar lingkungan.
**Example .ebextensions/xray-daemon.config**
```
option_settings:
aws:elasticbeanstalk:xray:
XRayEnabled: true
```
Elastic Beanstalk melewati file konfigurasi ke daemon dan output log ke lokasi standar.
**Pada Platform Server Windows**
+ **file konfigurasi** – `C:\Program Files\Amazon\XRay\cfg.yaml`
+ **Log** – `c:\Program Files\Amazon\XRay\logs\xray-service.log`
**Pada Platform Linux**
+ **File konfigurasi** – `/etc/amazon/xray/cfg.yaml`
+ **Log** – `/var/log/xray/xray.log`
Elastic Beanstalk menyediakan alat untuk menarik log Konsol Manajemen AWS instance dari atau baris perintah. Anda dapat memberitahu Elastic Beanstalk untuk memasukkan log X-Ray daemon dengan menambahkan tugas dengan file konfigurasi.
**Example .ebextensions/xray-logs.config - Linux**
```
files:
"/opt/elasticbeanstalk/tasks/taillogs.d/xray-daemon.conf" :
mode: "000644"
owner: root
group: root
content: |
/var/log/xray/xray.log
```
**Example .ebextensions/xray-logs.config - server Windows**
```
files:
"c:/Program Files/Amazon/ElasticBeanstalk/config/taillogs.d/xray-daemon.conf" :
mode: "000644"
owner: root
group: root
content: |
c:\Progam Files\Amazon\XRay\logs\xray-service.log
```
Lihat [Melihat Log dari Elastic Beanstalk Lingkungan Instans Amazon EC2 Anda](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/using-features.logging.html) di *AWS Elastic Beanstalk Panduan Developer* untuk informasi lebih lanjut.
## Mengunduh dan menjalankan daemon X-Ray secara manual (lanjutan)
Jika daemon X-Ray tidak tersedia untuk konfigurasi platform Anda, Anda dapat mengunduhnya dari Amazon S3 dan jalankan dengan file konfigurasi.
Gunakan file konfigurasi Elastic Beanstalk untuk mengunduh dan menjalankan daemon.
**Example .ebextensions/xray.config - Linux**
```
commands:
01-stop-tracing:
command: yum remove -y xray
ignoreErrors: true
02-copy-tracing:
command: curl https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.rpm -o /home/ec2-user/xray.rpm
03-start-tracing:
command: yum install -y /home/ec2-user/xray.rpm
files:
"/opt/elasticbeanstalk/tasks/taillogs.d/xray-daemon.conf" :
mode: "000644"
owner: root
group: root
content: |
/var/log/xray/xray.log
"/etc/amazon/xray/cfg.yaml" :
mode: "000644"
owner: root
group: root
content: |
Logging:
LogLevel: "debug"
Version: 2
```
**Example .ebextensions/xray.config - server Windows**
```
container_commands:
01-execute-config-script:
command: Powershell.exe -ExecutionPolicy Bypass -File c:\\temp\\installDaemon.ps1
waitAfterCompletion: 0
files:
"c:/temp/installDaemon.ps1":
content: |
if ( Get-Service "AWSXRayDaemon" -ErrorAction SilentlyContinue ) {
sc.exe stop AWSXRayDaemon
sc.exe delete AWSXRayDaemon
}
$targetLocation = "C:\Program Files\Amazon\XRay"
if ((Test-Path $targetLocation) -eq 0) {
mkdir $targetLocation
}
$zipFileName = "aws-xray-daemon-windows-service-3.x.zip"
$zipPath = "$targetLocation\$zipFileName"
$destPath = "$targetLocation\aws-xray-daemon"
if ((Test-Path $destPath) -eq 1) {
Remove-Item -Recurse -Force $destPath
}
$daemonPath = "$destPath\xray.exe"
$daemonLogPath = "$targetLocation\xray-daemon.log"
$url = "https://s3.dualstack.us-west-2.amazonaws.com/aws-xray-assets.us-west-2/xray-daemon/aws-xray-daemon-windows-service-3.x.zip"
Invoke-WebRequest -Uri $url -OutFile $zipPath
Add-Type -Assembly "System.IO.Compression.Filesystem"
[io.compression.zipfile]::ExtractToDirectory($zipPath, $destPath)
New-Service -Name "AWSXRayDaemon" -StartupType Automatic -BinaryPathName "`"$daemonPath`" -f `"$daemonLogPath`""
sc.exe start AWSXRayDaemon
encoding: plain
"c:/Program Files/Amazon/ElasticBeanstalk/config/taillogs.d/xray-daemon.conf" :
mode: "000644"
owner: root
group: root
content: |
C:\Program Files\Amazon\XRay\xray-daemon.log
```
Contoh-contoh ini juga menambahkan berkas log daemon ke tugas log ekor Elastic Beanstalk, sehingga disertakan ketika Anda meminta log dengan konsol tersebut atau Elastic Beanstalk Command Line Interface (EB CLI).
# Menjalankan daemon X-Ray di Amazon EC2
**catatan**
Pemberitahuan SDK/Daemon Pemeliharaan X-Ray - Pada 25 Februari 2026, AWS SDKs/Daemon X-Ray akan memasuki mode pemeliharaan, di mana AWS akan membatasi rilis X-Ray SDK dan Daemon untuk mengatasi masalah keamanan saja. Untuk informasi selengkapnya tentang garis waktu dukungan, lihat[Garis waktu Dukungan X-Ray SDK dan Daemon](xray-sdk-daemon-timeline.md). Kami merekomendasikan untuk bermigrasi ke OpenTelemetry. Untuk informasi lebih lanjut tentang migrasi ke OpenTelemetry, lihat [Migrasi dari instrumentasi X-Ray ke instrumentasi](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry
Anda dapat menjalankan daemon X-Ray pada sistem operasi berikut di Amazon: EC2
+ Amazon Linux
+ Ubuntu
+ Server Windows (2012 R2 dan yang lebih baru)
Gunakan profil instans untuk memberikan daemon izin untuk mengunggah data pelacakan ke X-Ray. Untuk informasi selengkapnya, lihat [Memberikan izin kepada daemon untuk mengirim data ke X-Ray](xray-daemon.md#xray-daemon-permissions).
Gunakan skrip data pengguna untuk menjalankan daemon secara otomatis saat Anda meluncurkan instans.
**Example Skrip data pengguna - Linux**
```
#!/bin/bash
curl https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.rpm -o /home/ec2-user/xray.rpm
yum install -y /home/ec2-user/xray.rpm
```
**Example Skrip data pengguna - Server Windows**
```
if ( Get-Service "AWSXRayDaemon" -ErrorAction SilentlyContinue ) {
sc.exe stop AWSXRayDaemon
sc.exe delete AWSXRayDaemon
}
$targetLocation = "C:\Program Files\Amazon\XRay"
if ((Test-Path $targetLocation) -eq 0) {
mkdir $targetLocation
}
$zipFileName = "aws-xray-daemon-windows-service-3.x.zip"
$zipPath = "$targetLocation\$zipFileName"
$destPath = "$targetLocation\aws-xray-daemon"
if ((Test-Path $destPath) -eq 1) {
Remove-Item -Recurse -Force $destPath
}
$daemonPath = "$destPath\xray.exe"
$daemonLogPath = "$targetLocation\xray-daemon.log"
$url = "https://s3.dualstack.us-west-2.amazonaws.com/aws-xray-assets.us-west-2/xray-daemon/aws-xray-daemon-windows-service-3.x.zip"
Invoke-WebRequest -Uri $url -OutFile $zipPath
Add-Type -Assembly "System.IO.Compression.Filesystem"
[io.compression.zipfile]::ExtractToDirectory($zipPath, $destPath)
New-Service -Name "AWSXRayDaemon" -StartupType Automatic -BinaryPathName "`"$daemonPath`" -f `"$daemonLogPath`""
sc.exe start AWSXRayDaemon
```
# Menjalankan daemon X-Ray di Amazon ECS
**catatan**
Pemberitahuan SDK/Daemon Pemeliharaan X-Ray - Pada 25 Februari 2026, AWS SDKs/Daemon X-Ray akan memasuki mode pemeliharaan, di mana AWS akan membatasi rilis X-Ray SDK dan Daemon untuk mengatasi masalah keamanan saja. Untuk informasi selengkapnya tentang garis waktu dukungan, lihat[Garis waktu Dukungan X-Ray SDK dan Daemon](xray-sdk-daemon-timeline.md). Kami merekomendasikan untuk bermigrasi ke OpenTelemetry. Untuk informasi lebih lanjut tentang migrasi ke OpenTelemetry, lihat [Migrasi dari instrumentasi X-Ray ke instrumentasi](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry
Di Amazon ECS, buat citra Docker yang menjalankan daemon X-Ray, unggah ke repositori citra Docker, lalu deploy ke klaster Amazon ECS Anda. Anda dapat menggunakan pemetaan port dan pengaturan mode jaringan dalam file ketentuan tugas Anda untuk memungkinkan aplikasi Anda berkomunikasi dengan kontainer daemon.
## Menggunakan citra Docker resmi
X-Ray menyediakan [image kontainer](https://gallery.ecr.aws/xray/aws-xray-daemon) Docker di Amazon ECR yang dapat Anda terapkan bersama aplikasi Anda. Lihat [mengunduh daemon untuk informasi](xray-daemon.md#xray-daemon-downloading) lebih lanjut.
**Example Ketentuan tugas**
```
{
"name": "xray-daemon",
"image": "amazon/aws-xray-daemon",
"cpu": 32,
"memoryReservation": 256,
"portMappings" : [
{
"hostPort": 0,
"containerPort": 2000,
"protocol": "udp"
}
]
}
```
## Buat dan bangun citra Docker
Untuk konfigurasi kustom, Anda mungkin perlu menentukan citra Docker milik Anda sendiri.
Tambahkan kebijakan terkelola ke peran tugas Anda untuk memberikan izin kepada daemon untuk mengunggah data pelacakan ke X-Ray. Untuk informasi selengkapnya, lihat [Memberikan izin kepada daemon untuk mengirim data ke X-Ray](xray-daemon.md#xray-daemon-permissions).
Gunakan salah satu file Docker berikut untuk membuat citra yang menjalankan daemon.
**Example Dockerfile – Amazon Linux**
```
FROM amazonlinux
RUN yum install -y unzip
RUN curl -o daemon.zip https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-3.x.zip
RUN unzip daemon.zip && cp xray /usr/bin/xray
ENTRYPOINT ["/usr/bin/xray", "-t", "0.0.0.0:2000", "-b", "0.0.0.0:2000"]
EXPOSE 2000/udp
EXPOSE 2000/tcp
```
**catatan**
Flag `-t` dan `-b` diperlukan untuk menentukan alamat pengikatan untuk mendengarkan loopback dari lingkungan multi-kontainer.
**Example Dockerfile – Ubuntu**
Untuk turunan Debian, Anda juga perlu menginstal sertifikat otoritas sertifikasi (CA) untuk menghindari masalah saat mengunduh penginstal.
```
FROM ubuntu:16.04
RUN apt-get update && apt-get install -y --force-yes --no-install-recommends apt-transport-https curl ca-certificates wget && apt-get clean && apt-get autoremove && rm -rf /var/lib/apt/lists/*
RUN wget https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.deb
RUN dpkg -i aws-xray-daemon-3.x.deb
ENTRYPOINT ["/usr/bin/xray", "--bind=0.0.0.0:2000", "--bind-tcp=0.0.0.0:2000"]
EXPOSE 2000/udp
EXPOSE 2000/tcp
```
Dalam ketentuan tugas Anda, konfigurasi tergantung pada mode jaringan yang Anda gunakan. Jaringan jembatan adalah default dan dapat digunakan di VPC default Anda. Di jaringan jembatan, atur variabel lingkungan `AWS_XRAY_DAEMON_ADDRESS` untuk memberi tahu SDK X-Ray, port kontainer yang akan dirujuk dan mengatur port host. Misalnya, Anda dapat memublikasikan UDP port 2000, dan membuat tautan dari kontainer aplikasi Anda ke kontainer daemon.
**Example Ketentuan tugas**
```
{
"name": "xray-daemon",
"image": "123456789012.dkr.ecr.us-east-2.amazonaws.com/xray-daemon",
"cpu": 32,
"memoryReservation": 256,
"portMappings" : [
{
"hostPort": 0,
"containerPort": 2000,
"protocol": "udp"
}
]
},
{
"name": "scorekeep-api",
"image": "123456789012.dkr.ecr.us-east-2.amazonaws.com/scorekeep-api",
"cpu": 192,
"memoryReservation": 512,
"environment": [
{ "name" : "AWS_REGION", "value" : "us-east-2" },
{ "name" : "NOTIFICATION_TOPIC", "value" : "arn:aws:sns:us-east-2:123456789012:scorekeep-notifications" },
{ "name" : "AWS_XRAY_DAEMON_ADDRESS", "value" : "xray-daemon:2000" }
],
"portMappings" : [
{
"hostPort": 5000,
"containerPort": 5000
}
],
"links": [
"xray-daemon"
]
}
```
Jika Anda menjalankan klaster di subnet privat VPC, Anda dapat menggunakan [mode jaringan `awsvpc`](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html) untuk melampirkan antarmuka jaringan elastis (ENI) ke kontainer Anda. Hal ini memungkinkan Anda untuk menghindari penggunaan tautan. Abaikan port host di pemetaan port, tautan, dan variabel lingkungan `AWS_XRAY_DAEMON_ADDRESS`.
**Example Ketentuan tugas VPC**
```
{
"family": "scorekeep",
"networkMode":"awsvpc",
"containerDefinitions": [
{
"name": "xray-daemon",
"image": "123456789012.dkr.ecr.us-east-2.amazonaws.com/xray-daemon",
"cpu": 32,
"memoryReservation": 256,
"portMappings" : [
{
"containerPort": 2000,
"protocol": "udp"
}
]
},
{
"name": "scorekeep-api",
"image": "123456789012.dkr.ecr.us-east-2.amazonaws.com/scorekeep-api",
"cpu": 192,
"memoryReservation": 512,
"environment": [
{ "name" : "AWS_REGION", "value" : "us-east-2" },
{ "name" : "NOTIFICATION_TOPIC", "value" : "arn:aws:sns:us-east-2:123456789012:scorekeep-notifications" }
],
"portMappings" : [
{
"containerPort": 5000
}
]
}
]
}
```
## Konfigurasikan opsi baris perintah di konsol Amazon ECS
Opsi baris perintah mengganti nilai-nilai yang bertentangan dalam file konfigurasi citra Anda. Opsi baris perintah biasanya digunakan untuk pengujian lokal, tetapi juga dapat digunakan untuk memudahkan saat mengatur variabel lingkungan, atau mengontrol proses startup.
Dengan menambahkan opsi baris perintah, Anda memperbarui `CMD` Docker yang diteruskan ke kontainer. Untuk informasi selengkapnya, lihat [Referensi menjalankan Docker](https://docs.docker.com/engine/reference/run/#overriding-dockerfile-image-defaults).
**Untuk mengatur opsi baris perintah**
1. Buka konsol klasik Amazon ECS di [https://console.aws.amazon.com/ecs/](https://console.aws.amazon.com/ecs/).
1. Dari bilah navigasi, pilih wilayah yang berisi ketentuan tugas Anda.
1. Di panel navigasi, pilih **Ketentuan Tugas**.
1. Di halaman **Ketentuan Tugas**, pilih kotak di sebelah kiri ketentuan tugas yang akan direvisi dan pilih **Buat revisi baru**.
1. Di halaman **Buat revisi baru dari Ketentuan Tugas**, pilih kontainer.
1. Di bagian **LINGKUNGAN**, tambahkan daftar Anda yang dipisahkan koma dari opsi baris perintah ke bidang **Perintah**.
1. Pilih **Perbarui**.
1. Verifikasi informasi dan pilih **Buat**.
Contoh berikut menunjukkan cara menulis opsi baris perintah yang dipisahkan koma untuk opsi `RoleARN`. Opsi `RoleARN` mengasumsikan IAM role yang ditentukan untuk mengunggah segmen ke akun yang berbeda.
**Example**
```
--role-arn, arn:aws:iam::123456789012:role/xray-cross-account
```
Untuk mempelajari lebih lanjut tentang opsi baris perintah yang tersedia di X-Ray, lihat [Mengonfigurasi AWS X-Ray Daemon](xray-daemon-configuration.md).