Mengkonfigurasi daemon AWS X-Ray

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 lokal, yaitu, tidak di Amazon EC2, Anda dapat menambahkan -o untuk melewatkan pemeriksaan kredensial profil instans sehingga daemon akan menjadi 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.

Variabel lingkungan yang didukung

Daemon X-Ray mendukung variabel lingkungan berikut:

• AWS_REGION— Menentukan titik Wilayah AWSakhir 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 metadata untuk instans EC2.

• -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 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 atauprod,warn,error. prod Secara default adalah prod, yang setara dengan info.

  • LogPath – Output log ke jalur file yang ditentukan.

• LocalMode – Set ke true untuk melewatkan pemeriksaan instans EC2 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.

contoh 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