Recopilación de registros
Información general
La recopilación de registros y la reproducción de problemas ralentizan el diagnóstico y degradan la experiencia del usuario. La función Tracing On facilita estas tareas. El rastreo está habilitado para el VDA de Linux de forma predeterminada.
Configuración
El demonio ctxlogd y la utilidad setlog ahora se incluyen en el paquete de la versión del VDA de Linux. 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. Puedes detener el demonio ctxlogd si no quieres mantener el VDA de Linux rastreado.
La utilidad setlog
Tracing On se configura mediante la utilidad setlog, que se encuentra en la ruta /opt/Citrix/VDA/bin/. Solo el usuario root tiene el privilegio de ejecutarla. Puedes usar la GUI o ejecutar comandos para ver y cambiar las configuraciones. Ejecuta el siguiente comando para obtener ayuda con la utilidad setlog:
setlog help
<!--NeedCopy-->
Valores
De forma predeterminada, la Ruta de salida de registros se establece en /var/log/xdl/hdx.log, el Tamaño máximo de registros se establece en 200 MB, y puedes guardar hasta dos archivos de registro antiguos en la Ruta de salida de registros.
Para 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-->
Para ver o establecer un único 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 en warning (sin distinción entre mayúsculas y minúsculas).
Para ver los niveles de registro establecidos para los diferentes componentes, ejecuta el siguiente comando:
setlog levels
<!--NeedCopy-->
Para establecer los niveles de registro (incluidos Disabled, Inherited, Verbose, Information, Warnings, Errors y Fatal Errors), ejecuta el siguiente comando:
setlog level <class> [<level>]
<!--NeedCopy-->
| Nivel de registro | Parámetro de comando (sin distinción entre mayúsculas y minúsculas) |
|---|---|
| Deshabilitado | none |
| Heredado | inherit |
| Detallado | verbose |
| Información | info |
| Advertencias | warning |
| Errores | error |
| Errores graves | fatal |
La variable <class> especifica un componente del VDA de Linux. Para cubrir todos los componentes, establécela en all. Por ejemplo:
setlog level all error
<!--NeedCopy-->
Marcadores
De forma predeterminada, los marcadores se establecen de la siguiente manera:
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-->
Para ver los marcadores actuales:
setlog flags
<!--NeedCopy-->
Para ver o establecer un único marcador de registro:
setlog flag <flag> [<state>]
<!--NeedCopy-->
Restaurar valores predeterminados
Para revertir todos los niveles, marcadores y valores a la configuración predeterminada:
setlog default
<!--NeedCopy-->
Importante:
El servicio
ctxlogdse configura mediante el archivo /var/xdl/.ctxlog, que solo los usuarios root pueden crear. Otros usuarios no tienen permiso de escritura para este archivo. Recomendamos que los usuarios root no otorguen permiso de escritura a otros usuarios. El incumplimiento puede provocar una configuración arbitraria o maliciosa enctxlogd, lo que puede afectar el rendimiento del servidor y, por lo tanto, la experiencia del usuario.
Recopilación de registros
Puedes ejecutar el comando bash /opt/Citrix/VDA/bin/xdlcollect.sh para recopilar registros. El script Bash xdlcollect que se usa para recopilar registros está integrado en el software del VDA de Linux y se encuentra en /opt/Citrix/VDA/bin.
Una vez finalizada la recopilación de registros, se genera un archivo de registro comprimido en la misma carpeta que el script. El script Bash xdlcollect puede preguntarte si quieres cargar el archivo de registro comprimido en Citrix Insight Services (CIS). Si aceptas, xdlcollect devuelve un upload_ID una vez finalizada la carga. La carga no elimina el archivo de registro comprimido de tu máquina local. Otros usuarios pueden usar el upload_ID para acceder al archivo de registro en CIS.
Solución de problemas
El demonio ctxlogd falla y no puedes reiniciar el servicio ctxlogd cuando falta el archivo /var/xdl/.ctxlog (por ejemplo, si se elimina accidentalmente).
/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 solucionar este problema, ejecuta setlog como usuario root para volver a crear el archivo /var/xdl/.ctxlog. Luego, reinicia el servicio ctxlogd del que dependen otros servicios.