4.5 Registro

4.5.1 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.

4.5.2 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.max-size
   logging.file.max-history

4.5.3 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:Las líneas en service.yml deben ser sangradas usando 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 Depurar

  • Debug - designa eventos informativos de nivel granular fino que son muy útiles para depurar una aplicación.

  • Info - designa mensajes informativos que realzan el progreso de la aplicación a 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 severos 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.

4.5.4 Registro del cliente Web en el servidor de 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 disponibles son: "debug" (depuración), "info" (información), "warn" (advertencia), "error" y "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: <registrador>
  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.