Configuración del AWS X-Ray daemon

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 rastreo a X-Ray.

~/xray-daemon$ ./xray -n us-east-2

Si no ejecuta el daemon en Amazon EC2, sino localmente, puede agregar la opción -o para omitir la comprobación de las credenciales del perfil de instancia, de modo que el daemon esté listo con mayor rapidez.

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

Variables de entorno admitidas

El daemon de X-Ray admite las siguientes variables de entorno:

• AWS_REGION: especifica la Región de AWS 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 comprueban los metadatos de la instancia de EC2.

• -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 en un puerto TCP diferente.

• Logging: configura el comportamiento de registro.

  • LogRotation: se establece en false para deshabilitar la rotación de registros.

  • LogLevel— Cambie el nivel de registro, del más detallado al menos detallado:dev,, info odebug,prod,warn,error. prod El valor predeterminado es prod, que equivale a info.

  • LogPath: envía los registros a la ruta de archivo especificada.

• LocalMode: se establece en true para omitir la comprobación de los metadatos de la instancia de EC2.

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

ejemplo 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