Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Exécution du daemon X-Ray sur AWS Elastic Beanstalk
**Note**
Avis de SDK/Daemon maintenance de X-Ray — Le 25 février 2026, le AWS X-Ray SDKs/Daemon passera en mode maintenance, où les versions du SDK et du Daemon de X-Ray AWS seront limitées uniquement pour résoudre les problèmes de sécurité. Pour plus d'informations sur le calendrier de support, consultez[Chronologie du support pour le SDK et Daemon X-Ray](xray-sdk-daemon-timeline.md). Nous vous recommandons de migrer vers OpenTelemetry. Pour plus d'informations sur la migration vers OpenTelemetry, voir [Migration de l'instrumentation X-Ray vers OpenTelemetry l'instrumentation](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html).
Pour relayer les données de suivi de votre application vers AWS X-Ray, vous pouvez exécuter le démon X-Ray sur les instances Amazon EC2 de votre environnement Elastic Beanstalk. Pour obtenir la liste des plateformes prises en charge, consultez [la section Configuration du AWS X-Ray débogage](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/environment-configuration-debugging.html) dans le *guide du AWS Elastic Beanstalk développeur*.
**Note**
Le démon utilise le profil d'instance de votre environnement pour les autorisations. Pour obtenir des instructions sur l'ajout d'autorisations au profil d'instance Elastic Beanstalk, consultez. [Autoriser le daemon à envoyer des données à X-Ray](xray-daemon.md#xray-daemon-permissions)
Les plateformes Elastic Beanstalk fournissent une option de configuration que vous pouvez définir pour exécuter le daemon automatiquement. Vous pouvez activer le daemon dans un fichier de configuration de votre code source ou en choisissant une option dans la console Elastic Beanstalk. Lorsque vous activez l'option de configuration, le démon est installé sur l'instance et s'exécute en tant que service.
La version incluse sur les plateformes Elastic Beanstalk n'est peut-être pas la dernière version. Consultez la [rubrique Plateformes prises en charge](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/concepts.platforms.html) pour identifier la version du démon disponible pour votre configuration de plateforme.
Elastic Beanstalk ne fournit pas le daemon X-Ray sur la plateforme Multicontainer Docker (Amazon ECS).
## Utilisation de l'intégration Elastic Beanstalk X-Ray pour exécuter le daemon X-Ray
Utilisez la console pour activer l'intégration de X-Ray ou configurez-la dans le code source de votre application à l'aide d'un fichier de configuration.
**Pour activer le daemon X-Ray dans la console Elastic Beanstalk**
1. Ouvrez la [console Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk).
1. Accédez à la [console de gestion](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/environments-console.html) de votre environnement.
1. Choisissez **Configuration**.
1. Choisissez **Software Settings**.
1. Pour **Daemon X-Ray**, choisissez **Enabled**.
1. Cliquez sur **Appliquer**.
Vous pouvez inclure un fichier de configuration dans votre code source pour que votre configuration soit portable entre les environnements.
**Example .ebextensions/xray-daemon.config**
```
option_settings:
aws:elasticbeanstalk:xray:
XRayEnabled: true
```
Elastic Beanstalk transmet un fichier de configuration au daemon et génère des journaux vers un emplacement standard.
**Sur les plateformes Windows Server**
+ **Fichier de configuration** — `C:\Program Files\Amazon\XRay\cfg.yaml`
+ **Journaux** — `c:\Program Files\Amazon\XRay\logs\xray-service.log`
**Sur les plateformes Linux**
+ **Fichier de configuration** — `/etc/amazon/xray/cfg.yaml`
+ **Journaux** — `/var/log/xray/xray.log`
Elastic Beanstalk fournit des outils permettant d'extraire les journaux AWS Management Console d'instance depuis la ligne de commande or. Vous pouvez demander à Elastic Beanstalk d'inclure les journaux du daemon X-Ray en ajoutant une tâche avec un fichier de configuration.
**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 - Windows Server**
```
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
```
Consultez les [journaux des *AWS Elastic Beanstalk instances* Amazon EC2 de votre environnement Elastic Beanstalk dans le manuel du](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/using-features.logging.html) développeur pour plus d'informations.
## Téléchargement et exécution manuels du daemon X-Ray (niveau avancé)
Si le daemon X-Ray n'est pas disponible pour la configuration de votre plateforme, vous pouvez le télécharger depuis Amazon S3 et l'exécuter avec un fichier de configuration.
Utilisez un fichier de configuration Elastic Beanstalk pour télécharger et exécuter le 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 - Windows Server**
```
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
```
Ces exemples ajoutent également le fichier journal du démon à la tâche Elastic Beanstalk tail logs, afin qu'il soit inclus lorsque vous demandez des journaux via la console ou l'interface de ligne de commande Elastic Beanstalk (EB CLI).