Registro
Ubicar archivos de registro
Hay dos archivos de registro disponibles:
-
<directorio_de_instalación>/sessionserver/sessionserver.log
- el archivo de registro para la aplicación del servidor de sesión. -
<directorio_de_instalación>/sessionserver/container.log
- el archivo de registro del contenedor que aloja la aplicación Host Access for the Cloud.
Configurar la rotación de registros
Para configurar la rotación de registros, edite los valores de <directorio_de_instalación>\sessionserver\microservices\sessionserver\service.yml
:
LOGGING_FILE_MAXSIZE
LOGGING_FILE_MAXHISTORY
Configurar niveles de registro
Hay varios tipos de niveles de registro que usted puede utilizar para producir distintos tipos de información. Puede configurar niveles de registro en <directorio_de_instalación>\sessionserver\microservices\sessionserver\service.yml
.
nota
Deben aplicarse sangrías a las líneas en service.yml
mediante espacios.
Utilice el siguiente formato para establecer los niveles de registro:
- nombre: logging.level.<logger>
valor: "<log level>"
Donde <logger>
es el nombre del registrador a ajustar y <log level>
es uno de los siguientes:
-
Trace: designa eventos informativos de nivel granular más fino que "Debug".
-
Debug: designa eventos informativos de nivel granular fino que son muy útiles para depurar una aplicación.
-
Info: designa mensajes informativos que resaltan el progreso de la aplicación en un nivel granular grueso.
-
Warn: designa situaciones potencialmente nocivas.
-
Error: designa eventos de error que pueden permitir que la ejecución de la aplicación continúe.
-
Fatal: designa eventos de error muy graves que posiblemente harán que la aplicación finalice.
Nota
Debe reiniciar el servidor de sesión después de realizar cambios en service.yml
.
Cómo habilitar el registro de servidor de cliente web a sesión
Aunque el navegador proporciona un mecanismo básico para entrar a su consola de JavaScript, el cliente Web amplía esta función y, con algo de configuración, se pueden registrar eventos en el servidor de sesión para que los vea un administrador.
Por defecto, no se registra nada en el servidor de sesión. Para poder habilitar esta función, debe definir el nivel de registro mediante las instrucciones que se indican a continuación.
Los niveles de registro son: debug
(depuración), info
(información), warn
(advertencia), error
u off
(desactivado). El nivel de registro por defecto es off
(desactivado).
Ajuste del nivel de registro para los usuarios de todos los clientes web
Para ajustar el nivel de registro para todos los clientes Web, añada la siguiente entrada a <directorio_de_instalación>\sessionserver\microservices\sessionserver\service.yml
-name: <registrador>
value: "<nivel de registro>"
Donde <registrador>
es:
logging.level.com.microfocus.zfe.webclient.core.handler.ClientLoggingHandler-webclient
Nota
Tenga cuidado al aumentar el nivel de registro para los usuarios de todos los clientes web en un entorno de producción debido a que puede producirse un aumento en el tráfico de red.
Ajuste del nivel de registro para un usuario individual
Existen dos opciones para ajustar el nivel de registro de usuarios individuales:
-
Para ajustar temporalmente el nivel de registro para una instancia de cliente Web de un usuario específico sin necesidad de reiniciar el servidor de sesión, indique al usuario que añada el siguiente parámetro de URL al cargar el cliente Web en el navegador:
-
https://mysessionserver.com:7443/?log=<nivel de registro>
- -
Para ajustar el nivel de registro de un usuario individual sin necesidad de que este realice cambios, añada la siguiente entrada a
service.yml
:-name: <logger value: "<nivel de registro>"
Donde
<registrador>
es:logging.level.com.microfocus.zfe.webclient.core.handler.ClientLoggingHandler-webclient-<nombre de usuario>
Donde
<nombre de usuario>
es el nombre de usuario de la persona cuyos niveles de registro se van a ajustar.
Nota
El registro basado en un nombre de usuario requiere un modo de autenticación que incluya nombres de usuario.