

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

# Menjalankan daemon X-Ray AWS Elastic Beanstalk
<a name="xray-daemon-beanstalk"></a>

**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
<a name="xray-daemon-beanstalk-option"></a>

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)
<a name="xray-daemon-beanstalk-manual"></a>

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