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