Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Configuración del AWS X-Ray daemon
**nota**
Aviso de SDK/Daemon mantenimiento de X-Ray: el 25 de febrero de 2026, el AWS X-Ray SDKs/Daemon entrará en modo de mantenimiento, donde AWS se limitarán las versiones de X-Ray SDK y Daemon para abordar únicamente los problemas de seguridad. Para obtener más información sobre la cronología del soporte, consulte [Cronología de X-Ray SDK y Daemon Support](xray-sdk-daemon-timeline.md). Recomendamos migrar a. OpenTelemetry Para obtener más información sobre la migración a OpenTelemetry, consulte [Migración de una instrumentación de rayos X a una instrumentación](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry
Puede utilizar las opciones de la línea de comandos o un archivo de configuración para personalizar el comportamiento del daemon de X-Ray. La mayoría de las opciones están disponibles con ambos métodos, pero algunas solo están disponibles en los archivos de configuración y otras solo en la línea de comandos.
Para empezar, la única opción que debe conocer es `-n` o `--region`, que se utiliza para establecer la región que el daemon utiliza para enviar los datos de rastro a X-Ray.
```
~/xray-daemon$ ./xray -n us-east-2
```
Si ejecuta el daemon localmente, es decir, no en Amazon EC2, puede añadir la `-o` opción de omitir la comprobación de las credenciales del perfil de la instancia para que el daemon esté listo más rápidamente.
```
~/xray-daemon$ ./xray -o -n us-east-2
```
El resto de las opciones de la línea de comandos le permiten configurar el registro, escuchar en otro puerto, limitar la cantidad de memoria que puede utilizar el demonio o asumir un rol para enviar datos de rastreo a otra cuenta.
Puede pasar un archivo de configuración al daemon para tener acceso a las opciones avanzadas de configuración y realizar tareas como limitar el número de llamadas simultáneas a X-Ray, deshabilitar la rotación de registros, y enviar tráfico a un proxy.
**Topics**
+ [Variables de entorno admitidas](#xray-daemon-configuration-variables)
+ [Uso de las opciones de la línea de comandos](#xray-daemon-configuration-commandline)
+ [Uso de un archivo de configuración](#xray-daemon-configuration-configfile)
## Variables de entorno admitidas
El daemon de X-Ray admite las siguientes variables de entorno:
+ `AWS_REGION`: especifica la [Región de AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html#cli-quick-configuration-region) del punto de conexión del servicio de X-Ray.
+ `HTTPS_PROXY`: especifica una dirección proxy a través de la cual el daemon puede cargar los segmentos. Se pueden utilizar un nombre de dominio DNS o una dirección IP y los números de puerto que utilizan los servidores proxy.
## Uso de las opciones de la línea de comandos
Pase estas opciones al demonio cuando lo ejecute localmente o con un script de datos de usuario.
**Opciones de la línea de comandos**
+ `-b`, `--bind`: buscan documentos de segmento en un puerto UDP diferente.
```
--bind "127.0.0.1:3000"
```
Valor predeterminado: `2000`.
+ `-t`, `--bind-tcp`: escuchan las llamadas al servicio de X-Ray en un puerto TCP diferente.
```
-bind-tcp "127.0.0.1:3000"
```
Valor predeterminado: `2000`.
+ `-c`, `--config`: cargan un archivo de configuración desde la ruta especificada.
```
--config "/home/ec2-user/xray-daemon.yaml"
```
+ `-f`, `--log-file`: envían registros a ruta de archivo especificada.
```
--log-file "/var/log/xray-daemon.log"
```
+ `-l`, `--log-level`: muestran el nivel de registro, desde el más detallado al menos detallado: dev, debug, info, warn, error y prod.
```
--log-level warn
```
Valor predeterminado: `prod`.
+ `-m`, `--buffer-memory`: cambian la cantidad de memoria en MB que pueden utilizar los búferes (mínimo 3).
```
--buffer-memory 50
```
Predeterminado: 1 % de memoria disponible
+ `-o`, `--local-mode` — No compruebes, por EC2 ejemplo, los metadatos.
+ `-r`, `--role-arn`: asumen el rol de IAM especificado para cargar segmentos en una cuenta diferente.
```
--role-arn "arn:aws:iam::123456789012:role/xray-cross-account"
```
+ `-a`, `--resource-arn` — Nombre de recurso de Amazon (ARN) del AWS recurso que ejecuta el daemon.
+ `-p`, `--proxy-address` — Cargue segmentos a AWS X-Ray través de un proxy. Hay que especificar el protocolo del servidor proxy.
```
--proxy-address "http://192.0.2.0:3000"
```
+ `-n`, `--region`: envían segmentos al servicio de X-Ray en una región específica.
+ `-v`, `--version` — Muestra la versión AWS X-Ray del daemon.
+ `-h`, `--help`: muestran la pantalla de ayuda.
## Uso de un archivo de configuración
También puede utilizar un archivo con formato YAML para configurar el demonio. Transfiera el archivo de configuración al demonio mediante la opción `-c`.
```
~$ ./xray -c ~/xray-daemon.yaml
```
**Configuración de las opciones de archivo**
+ `TotalBufferSizeMB`: tamaño máximo del búfer en MB (mínimo 3). Elija 0 para utilizar 1% de memoria del host.
+ `Concurrency`— Número máximo de llamadas simultáneas AWS X-Ray para cargar documentos segmentados.
+ `Region`— Enviar segmentos al AWS X-Ray servicio de una región específica.
+ `Socket`: configura el enlace del daemon.
+ `UDPAddress`: cambia el puerto en el que el daemon escucha.
+ `TCPAddress`: escucha [las llamadas al servicio de X-Ray](xray-api-sampling.md) en un puerto TCP diferente.
+ `Logging`: configura el comportamiento de registro.
+ `LogRotation`: se establece en `false` para deshabilitar la rotación de registros.
+ `LogLevel`: cambia el nivel de registro, desde el más detallado al menos: `dev`, `debug`, `info` o `prod`, `warn`, `error`, y `prod`. El valor predeterminado es `prod`, que equivale a `info`.
+ `LogPath`: envía los registros a la ruta de archivo especificada.
+ `LocalMode`— Configúrelo `true` para omitir la comprobación de los metadatos de la EC2 instancia.
+ `ResourceARN`— Nombre de recurso de Amazon (ARN) del AWS recurso que ejecuta el daemon.
+ `RoleARN`: asume el rol de IAM especificado para cargar segmentos en una cuenta diferente.
+ `ProxyAddress`— Cargue segmentos a AWS X-Ray través de un proxy.
+ `Endpoint`: cambia el punto de conexión del servicio de X-Ray al que el daemon envía documentos de segmento.
+ `NoVerifySSL`: desactiva la verificación del certificado TLS.
+ `Version`: versión de formato del archivo de configuración del daemon. La versión del formato del archivo es un campo **obligatorio**.
**Example Xray-daemon.yaml**
Este archivo de configuración cambia el puerto de escucha del demonio a 3000, desactiva las comprobaciones de metadatos de instancias, establece el rol que se usará para cargar segmentos y cambia las opciones de región y registro.
```
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
```