Recopilación de registros
Información general
Recopilar registros y reproducir problemas ralentiza los diagnósticos y degrada la experiencia del usuario. La función Rastreo activado permite reducir la carga. De forma predeterminada, el rastreo está habilitado para el VDA de Linux.
Configuración
A partir de ahora, 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
Rastreo activado 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 dectxlogd
, 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.
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.