Menjalankan X-Ray daemon AWS Elastic Beanstalk - AWS X-Ray

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menjalankan X-Ray daemon AWS Elastic Beanstalk

Untuk menyampaikan pelacakan data dari aplikasi Anda ke AWS X-Ray, Anda dapat menjalankan X-Ray daemon pada Instans Amazon EC2 Elastic Beanstalk lingkungan Anda. Untuk daftar platform yang didukung, lihat Mengonfigurasi AWS X-Ray Debugging 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.

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

  2. Arahkan ke konsol manajemen untuk lingkungan Anda.

  3. Pilih Konfigurasi.

  4. Pilih Pengaturan Perangkat Lunak.

  5. Untuk X-Ray daemon, pilih Diaktifkan.

  6. Pilih Apply (Terapkan).

Anda dapat menyertakan file konfigurasi dalam kode sumber Anda untuk membuat konfigurasi portabel antar lingkungan.

contoh .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 konfigurasiC:\Program Files\Amazon\XRay\cfg.yaml

  • Logc:\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 instans dari AWS Management Console atau baris perintah. Anda dapat memberitahu Elastic Beanstalk untuk memasukkan log X-Ray daemon dengan menambahkan tugas dengan file konfigurasi.

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

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