Recopilación de registros
Información general del mecanismo de registro
La siguiente tabla presenta una descripción general del mecanismo de registro para el VDA de Linux.
| Módulo de registro | Formato del nombre del archivo de registro | Ejemplo de nombre de archivo de registro | Alcance del registro | Tamaño máximo de un solo archivo | Umbral de rotación (valores predeterminados) | Configuración |
|---|---|---|---|---|---|---|
| HDX | hdx.log[.n] | hdx.log, hdx.log.1 | Gráficos, inicio de sesión, audio, teclado, ratón | 200 MiB | 1 actual, 2 antiguos | Configurable mediante la utilidad setlog |
| Jproxy | jproxy.log[.n.log] | jproxy.log, jproxy.log.1.log | Registro de VDA, autenticación de usuario | 20 MiB | 1 actual, 10 antiguos | Configurable 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 | Configurable mediante la utilidad setlog o /etc/xdl/brokeragent.conf |
Nota:
- El primer archivo de registro no tiene un número en su nombre, y los archivos posteriores 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 solo archivo de registro se mide en mebibytes (MiB).
- Un archivo de registro que se está generando y aún no ha alcanzado el tamaño máximo para un solo archivo se denomina archivo de registro “actual”. Cuando un archivo de registro “actual” alcanza el tamaño máximo para un solo archivo, se transfiere y se convierte en un archivo de registro “antiguo”.
- El umbral de rotación es configurable para limitar el número de archivos de registro “antiguos” que se pueden retener. Los archivos de registro más antiguos se eliminarán cuando se alcance el límite.
Configuración del registro
Esta sección proporciona información adicional sobre la configuración del registro, complementando los detalles descritos en la tabla anterior.
Registro habilitado de forma predeterminada para el VDA de Linux
El demonio ctxlogd y la utilidad setlog se incluyen en el paquete de lanzamiento del VDA de Linux. 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. Puedes detener el demonio ctxlogd si no quieres mantener el VDA de Linux rastreado.
Configurar el registro del VDA a través de /etc/xdl/brokeragent.conf
Nota:
Si solo buscas configurar los niveles de registro para el registro del VDA sin profundizar en otros parámetros de registro, como el tamaño máximo de un solo archivo de registro, puedes usar la utilidad setlog que se describe más adelante en este artículo. De lo contrario, usa /etc/xdl/brokeragent.conf.
El archivo /etc/xdl/brokeragent.conf en el VDA está disponible para configurar el registro del VDA. Por ejemplo:
Nota:
De forma predeterminada, el número máximo de archivos de registro “antiguos” del VDA que se pueden retener es 100. Ajústalo según sea necesario.
Configurar el registro de Jproxy a través de /etc/xdl/log4j2.xml
Nota:
Si solo buscas configurar los niveles de registro para el registro de Jproxy sin profundizar en otros parámetros de registro, como el tamaño máximo de un solo archivo de registro, puedes usar la utilidad setlog que se describe más adelante en este artículo. De lo contrario, usa /etc/xdl/log4j2.xml.
A continuación, se muestra un ejemplo de configuración del registro de Jproxy a través de /etc/xdl/log4j2.xml, donde el parámetro SizeBasedTriggeringPolicy especifica el tamaño máximo para un solo archivo de registro de Jproxy y el parámetro DefaultRollerStrategy establece el número total de archivos de registro de Jproxy que se pueden retener.
Configurar el registro de HDX™ a través de la utilidad setlog
La utilidad setlog 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 tus opciones de configuración, incluidos los valores (ruta del archivo de registro, límite de tamaño de un solo archivo y umbral de rotación) y los niveles de registro. Ejecuta el siguiente comando para obtener ayuda con la utilidad setlog:
setlog help
<!--NeedCopy-->
Valores
De forma predeterminada, los registros de HDX se guardan en /var/log/xdl/hdx.log, el límite de tamaño para un solo archivo de registro de HDX es de 200 MiB, y puedes guardar hasta dos archivos de registro de HDX “antiguos” en /var/log/xdl/hdx.log.
Para ver todos los valores actuales de setlog, ejecuta 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 único valor de setlog, ejecuta 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 en info (sin distinción entre mayúsculas y minúsculas).
Cuando encuentres un problema que requiera solución de problemas, te recomendamos que establezcas el nivel de registro en verbose en la mayoría de los escenarios. Después, reproduce el problema y recopila los registros.
Para establecer los niveles de registro (incluidos Deshabilitado, Heredado, Traza, Detallado, Información, Advertencias, Errores y Errores fatales), 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 |
| Traza | trace |
| Detallado | verbose |
| Información | info |
| Advertencias | warning |
| Errores | error |
| Errores fatales | 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-->
Para ver todas las clases o componentes compatibles, ejecuta el siguiente comando:
setlog levels
<!--NeedCopy-->
Restaurar valores predeterminados
Revierte todos los niveles y valores a la configuración predeterminada:
setlog default
<!--NeedCopy-->
Importante:
El servicio ctxlogd se configura utilizando el archivo /var/xdl/.ctxlog, que solo los usuarios root pueden crear. Otros usuarios no tienen permiso de escritura para este archivo. Te recomendamos que los usuarios root no den permiso de escritura a otros usuarios. El incumplimiento puede provocar una configuración arbitraria o maliciosa de ctxlogd, 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 utilizado para recopilar registros está integrado en el software del VDA de Linux 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 Bash xdlcollect puede preguntarte si deseas cargar el archivo de registro comprimido en Citrix Insight Services (CIS). Si aceptas, xdlcollect devuelve un upload_ID una vez completada 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 eliminó 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 resolver este problema, ejecuta setlog como usuario root para recrear el archivo /var/xdl/.ctxlog. Luego, reinicia el servicio ctxlogd del que dependen otros servicios.