Linux Virtual Delivery Agent

Recopilación de registros

Overview

La recopilación de registros está habilitada para Linux VDA de forma predeterminada.

Configuración

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.

El demonio ctxlogd

Todos los demás servicios que se rastrean dependen del demonio ctxlogd. Puede detener el demonio ctxlogd si no quiere rastrear Linux VDA.

La utilidad setlog

La recopilación de registros se configura con la utilidad setlog, ubicada en la ruta /opt/Citrix/VDA/bin/. Solo el usuario root tiene privilegios para ejecutarla. Puede utilizar la interfaz gráfica o ejecutar comandos para ver y cambiar las configuraciones. Ejecute el siguiente comando para obtener ayuda con la utilidad setlog:

setlog help
<!--NeedCopy-->

Valores

De forma predeterminada, la ruta de salida Log Output Path está establecida en /var/log/xdl/hdx.log, el tamaño máximo Max Log Size está establecido en 200 MB, y puede guardar dos archivos antiguos de registro como máximo en Log Output Path.

Ver los valores actuales de setlog:

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

Ver o establecer un solo valor de setlog:

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

Por ejemplo:

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

Niveles

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

Para ver los niveles de registro establecidos para los distintos componentes, ejecute el siguiente comando:

setlog levels
<!--NeedCopy-->

Para configurar los niveles de registro (incluidos Disable, Inherited, 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
Detallado verbose
Información info
Advertencia warning
Errores error
Errores irrecuperables fatal

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

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

Marcas

De forma predeterminada, las marcas se configuran como se muestra a continuación:

setlog flags

DATE = true

TIME = true

NAME = true

PID = true

TID = false

SID = true

UID = false

GID = false

CLASS = false

LEVEL = false

FUNC = true

FILE = false
<!--NeedCopy-->

Ver las marcas actuales:

setlog flags
<!--NeedCopy-->

Ver o establecer una sola marca de registro:

setlog flag <flag> [<state>]
<!--NeedCopy-->

Restaurar valores predeterminados

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

setlog default
<!--NeedCopy-->

Importante:

El servicio ctxlogd se configura desde el archivo /var/xdl/.ctxlog, que solo puede crear el usuario 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 del 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 completada la recopilación de registros, se genera un archivo de registro comprimido en la misma carpeta que el script. El script xdlcollect de Bash puede preguntarle si quiere cargar el archivo de registro comprimido en Citrix Insight Services (CIS). Si está de acuerdo, xdlcollect devuelve un upload_ID una vez completada la carga. La carga no elimina el archivo de registro comprimido de su máquina local. Otros usuarios pueden usar este upload_ID para acceder al archivo de registro en CIS.

Troubleshooting

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.

Recopilación de registros