Linux Virtual Delivery Agent

Recopilación de registros

Descripción general del mecanismo de registro

En la tabla siguiente se presenta una descripción general del mecanismo de registro de Linux VDA.

Módulo de registro Formato de nombre de archivo de registro Ejemplo de nombre de archivo de registro Alcance del registro Tamaño máximo de archivo único Umbral de rotación (predeterminado) Configuración
HDX hdx.log[.n] hdx.log, hdx.log.1 Gráficos, inicio de sesión, audio, teclado, mouse 200 MiB 1 actual, 2 antiguos Se puede configurar mediante la utilidad setlog
Jproxy jproxy.log[.n.log] jproxy.log, jproxy.log.1.log Registro de VDA, autenticación de usuarios 20 MiB 1 actual, 10 antiguos Se puede configurar mediante la utilidad setlog o /etc/xdl/log4j2.xml
VDA vda.YYYY-MM-DD.hh.mm.ss.log vda.2024-05-06.20.18.40.log Registro de VDA 10 MiB 1 actual, 100 antiguos Se puede configurar mediante la utilidad setlog o /etc/xdl/brokeragent.conf

Nota:

  • El nombre del primer archivo de registro no incluye ningún número y los archivos siguientes se numeran con “.n”, donde “n” representa el número de archivo. Por ejemplo, “hdx.log” es el primer archivo de registro de HDX y “hdx.log.1” es el segundo.
  • El tamaño máximo de un archivo único de registro se mide en mebibytes (MiB).
  • Un archivo de registro que se está generando y que aún no ha alcanzado el tamaño máximo para un archivo único se denomina archivo de registro “actual”. Cuando un archivo de registro “actual” alcanza el tamaño máximo para un archivo único, se transfiere y se convierte en un archivo de registro “antiguo”.
  • El umbral de rotación se puede configurar para limitar la cantidad de archivos de registro “antiguos” que se pueden conservar. Los archivos de registros más antiguos se eliminarán cuando se alcance el límite.

Configuración de captura de registros

Esta sección proporciona información adicional sobre la configuración de la captura de registros y complementa los detalles indicados en la tabla anterior.

La captura de registros está habilitada de forma predeterminada para el Linux VDA

El demonio ctxlogd y la utilidad setlog se incluyen en el paquete de la versión de Linux VDA. De forma predeterminada, el demonio ctxlogd se inicia después de instalar y configurar el VDA de Linux. Todos los demás servicios que se rastrean dependen del demonio ctxlogd. Puede detener el demonio ctxlogd si no quiere rastrear Linux VDA.

Configure la captura de registros de VDA mediante /etc/xdl/brokeragent.conf

Nota:

Si quiere configurar solo los niveles de registro para la captura de registros de los VDA sin profundizar en otros parámetros de captura de registros, como el tamaño máximo de un archivo único de registro, puede usar la utilidad setlog que se describe más adelante en este artículo. Si no, utilice /etc/xdl/brokeragent.conf.

El archivo /etc/xdl/brokeragent.conf en los VDA está disponible para configurar la captura de registros de los VDA. Por ejemplo:

El archivo /etc/xdl/brokeragent.conf

Nota:

De forma predeterminada, la cantidad máxima de archivos de registro de VDA “antiguos” que se pueden conservar es de 100. Ajústelo según sea necesario.

Configurar la VDA logging captura de registros de Jproxy a través de /etc/xdl/log4j2.xml

Nota:

Si quiere configurar solo los niveles de registro para la captura de registros de Jproxy sin profundizar en otros parámetros de captura de registros, como el tamaño máximo de un archivo único de registro, puede usar la utilidad setlog que se describe más adelante en este artículo. Si no, utilice /etc/xdl/log4j2.xml.

El siguiente es un ejemplo de configuración de la captura de registros de Jproxy mediante /etc/xdl/log4j2.xml, en el que el parámetro SizeBasedTriggeringPolicy especifica el tamaño máximo de un archivo único de registro de Jproxy y el parámetro DefaultRollerStrategy establece el número total de archivos de registro de Jproxy que se pueden conservar.

Configurar la captura de registros de Jproxy

Configurar la captura de registros de HDX mediante la utilidad setlog

La utilidad setlog reside en la ruta /opt/Citrix/VDA/bin/. Solo el usuario root tiene privilegios para ejecutarla. Puede usar la GUI o ejecutar comandos para ver y cambiar las opciones de configuración, incluidos los valores (ruta del archivo de registro, límite de tamaño de archivo único y umbral de rotación) y los niveles de registro. Ejecute el siguiente comando para obtener ayuda con la utilidad setlog:

setlog help
<!--NeedCopy-->

Valores

De forma predeterminada, los registros HDX se guardan en /var/log/xdl/hdx.log, el límite de tamaño para un archivo único de registro HDX es de 200 MiB y es posible guardar hasta dos archivos de registro HDX “antiguos” en /var/log/xdl/hdx.log.

Para ver todos los valores actuales de setlog, ejecute el siguiente comando:

setlog values

log_path (Log Output Path) = /var/log/xdl/hdx.log

log_size (Max Log Size (MiB)) = 200

log_count (Max Old Log Files) = 2
<!--NeedCopy-->

Para ver o establecer un valor único de setlog, ejecute el siguiente comando:

setlog value <name> [<value>]
<!--NeedCopy-->

Por ejemplo:

setlog value log_size 100
<!--NeedCopy-->

Niveles

De forma predeterminada, los niveles de registro se establecen como información (no se distingue entre mayúsculas y minúsculas).

Cuando encuentre un problema técnico que requiera solución, le recomendamos que establezca el nivel de registro en detallado en la mayoría de los casos. Después, reproduzca el problema y recopile los registros.

Para configurar los niveles de registro (incluidos Disable, Inherited, Trace, Verbose, Information, Warnings, Errors y Fatal Errors), ejecute el siguiente comando:

setlog level <class> [<level>]
<!--NeedCopy-->
Nivel de registro Parámetro de comando (no se distingue entre mayúsculas y minúsculas)
Inhabilitado none
Heredado inherit
Seguimiento trace
Detallado verbose
Información info
Advertencia warning
Errores error
Errores irrecuperables fatal

La variable <class> especifica un componente del Linux VDA. Para cubrir todos los componentes, establézcalos todos. Por ejemplo:

setlog level all error
<!--NeedCopy-->

Para ver todas las clases o componentes compatibles, ejecute el siguiente comando:

setlog levels
<!--NeedCopy-->

Restaurar valores predeterminados

Revertir todos los niveles y valores a los parámetros predeterminados:

setlog default
<!--NeedCopy-->

Importante:

El servicio ctxlogd se configura mediante el archivo /var/xdl/.ctxlog, que solo pueden crear los usuarios root. Los demás usuarios no tienen el permiso de escritura en este archivo. Se recomienda que los usuarios root no otorguen permisos de escritura a otros usuarios. No seguir esta premisa puede derivar en una configuración arbitraria o malintencionada de ctxlogd, que puede afectar al rendimiento del servidor y, por lo tanto, a la experiencia de usuario.

Recopilación de registros

Puede ejecutar el comando bash /opt/Citrix/VDA/bin/xdlcollect.sh para recopilar registros. El script xdlcollect de Bash que se usa para recopilar registros está integrado en el software de Linux VDA y se encuentra en /opt/Citrix/VDA/bin.

Una vez finalizada la recopilación de registros, se genera un archivo ZIP en /tmp/xdlcollect en el VDA.

Solución de problemas

El demonio ctxlogd falla y el servicio ctxlogd no se puede reiniciar si falta el archivo /var/xdl/.ctxlog (por ejemplo, si se ha eliminado por accidente).

/var/log/messages:

Apr 1 02:28:21 RH72 citrix-ctxlogd[17881]: Failed to open logging configuration file.

Apr 1 02:28:21 RH72 systemd: ctxlogd.service: main process exited, code=exited, status=1/FAILURE

Apr 1 02:28:21 RH72 systemd: Unit ctxlogd.service entered failed state.

Apr 1 02:28:21 RH72 systemd: ctxlogd.service failed.
<!--NeedCopy-->

Para resolver este problema, ejecute setlog como usuario root para volver a crear el archivo /var/xdl/.ctxlog. A continuación, reinicie el servicio ctxlogd, del que dependen los demás servicios.