Recopilación de registros
Descripció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 | Ámbito de registro | Tamaño máximo de archivo individual | 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 | 50 MiB | 1 actual, 1 antiguo | 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 archivo de registro individual 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 archivo individual se denomina archivo de registro “actual”. Cuando un archivo de registro “actual” alcanza el tamaño máximo para un archivo individual, 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 conservar. Los archivos de registro más antiguos se eliminarán cuando se alcance el límite.
Configuración de registros
Esta sección proporciona información adicional sobre la configuración de registros, complementando los detalles descritos en la tabla anterior.
Registros habilitados 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 los registros de VDA mediante /etc/xdl/brokeragent.conf
Nota:
Si solo buscas configurar los niveles de registro para los registros de VDA sin profundizar en otros parámetros de registro, como el tamaño máximo de un archivo de registro individual, 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 los registros de VDA. Por ejemplo:
Configurar los registros de Jproxy mediante /etc/xdl/log4j2.xml
Nota:
Si solo buscas configurar los niveles de registro para los registros de Jproxy sin profundizar en otros parámetros de registro, como el tamaño máximo de un archivo de registro individual, 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 de registros de Jproxy mediante /etc/xdl/log4j2.xml, en el que el parámetro SizeBasedTriggeringPolicy especifica el tamaño máximo para un archivo de registro de Jproxy individual y el parámetro DefaultRollerStrategy establece el número total de archivos de registro de Jproxy que se pueden conservar.
Configurar los registros de HDX™ mediante 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 archivo individual 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 archivo de registro de HDX individual 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 graves), 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 graves | fatal |
La variable <class> especifica un componente del VDA de Linux. Para cubrir todos los componentes, establécelo en all. Por ejemplo:
setlog level all error
<!--NeedCopy-->
Para ver todas las clases o componentes compatibles, ejecuta el siguiente comando:
setlog levels
<!--NeedCopy-->
Restablecer valores predeterminados
Restablece todos los niveles y valores a la configuración predeterminada:
setlog default
<!--NeedCopy-->
Importante:
El servicio ctxlogd se configura mediante 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 ZIP en /tmp/xdlcollect en el VDA.
Solución de problemas
El demonio ctxlogd falla y no puedes reiniciar el servicio ctxlogd si 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 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.