Logs del servidor

Localizar los ficheros de log

Los logs del servidor en una instalción estandard de productivo se encuentran en la carpeta:

C:\Archivos de programa (x86)\Global Planning Solutions\Bold WorkPlanner\Server\Servers\Workplanner\Log_n

El valor de la n de log_n coincidirá con el número del servidor configurado en el PlannerConfig.exe. Dentro de esta carpeta se pueden encontrar dos tipos de ficheros de log:

• Los que empiezan por zSvrErrors_ que contienen la información de ejecución del servidor y los errores y excepciones que se pueden producir.
• Los que empiezan por zServerCalls_ que contienen las secuencia de llamadas al servidor sean via SOAP o REST (JSON).

Activación y desactivación de logs online

Es posible activar y desactivar el log de llamadas del servidor (zServerCalls_) en tiempo real (sin reiniciar el servidor y sin afectar a las prestaciones). Este procedimiento es independiente de la configuración de arranque del servidor (flag “Log activo al iniciar el servidor”) que se haya puesto en el PlannerConfig.

Activar RESPONSE

Para activar las peticiones y a la vez las respuestas (sean SOAP o REST) en el log de llamadas del servidor (fichero zServerCalls_*.log) hay que hacer lo siguiente:

• Abrir un browser y poner la siguiente URL (sustituir por lo que corresponda):

http://localhost/servers/Test_TestWP/ISAPIBoldWP.dll/gps_webadmin/update?EnableAPILog=Enabled&EnableResponseAPILog=Enabled

El servidor responderá con la nueva configuración definida.

Desactivar RESPONSE

• Abrir un browser y poner la siguiente URL (sustituir por lo que corresponda):

http://localhost/servers/Test_TestWP/ISAPIBoldWP.dll/gps_webadmin/update?EnableAPILog=Enabled&EnableResponseAPILog=Disabled

El servidor responderá con la nueva configuración definida.

ATENCIÓN! Por defecto el log de RESPONSE debería estar siempre desactivado ya que puede llegar a ocupar una cantidad de espacio muy grande.

Activación y desactivación del SQL log

En la sección [General] se puede definir la variable SQLLog. Esta variable determina si se grabarán en el log (fichero zSvrErrors_) todos los comandos SQL que se vayan ejectuando en el servidor o no:

[General]
SQLLog=1
SQLCutTime=1000

Para refrescar el estado de esta variable es necesario además efectuar una llamada al ws ServerStatus, por ejemplo desde el propio cliente Windows.

Adicionalmente (y opcional) está la variable SQLCutTime: si vale 0(valor por defecto) se graba siempre el log. Si vale 1000 (como en el caso anterior) sólo se grabarán en el log las sentencias SQL que duren más de 1000 ms.

ATENCION! Por defecto también debería estar siempre desactivado el volumen ya que puede ser considerable. No olvidar desactivarla al terminar.

Seguimiento de webservices

El inicio y fin de una operación remota asíncrona queda anotado mediante los siguientes tags:

START TMonitoredOperation::RunPhases
END TMonitoredOperation::RunPhases

Seguimiento de sesiones clonadas

A veces en el log aparecen mensajes del estilo:

[14/06/2013 10:45:53 121735][281][wAzIoF9Dqp4 Clon: N58G6Ur8Mv5 (administrador)] …GestorUsuarios_ClonSession
[14/06/2013 10:45:53 121735][281][wAzIoF9Dqp4 Clon: N58G6Ur8Mv5 (administrador)] …M:Mon W BEGIN GestorMonitoredOperations::AddOperation (0)
[14/06/2013 10:45:53 121735][281][wAzIoF9Dqp4 Clon: N58G6Ur8Mv5 (administrador)] …M:Mon W END GestorMonitoredOperations::AddOperation (0)
[14/06/2013 10:45:53 121735][281][wAzIoF9Dqp4 Clon: N58G6Ur8Mv5 (administrador)] …M:Mon W BEGIN GestorMonitoredOperations::InitOperation (0)
[14/06/2013 10:45:53 121735][281][wAzIoF9Dqp4 Clon: N58G6Ur8Mv5 (administrador)] …M:Mon W END GestorMonitoredOperations::InitOperation (0)
[14/06/2013 10:45:53 121735][281][wAzIoF9Dqp4 Clon: N58G6Ur8Mv5 (administrador)] START TMonitoredOperation::InitRunPhases rest/report

Esto significa lo siguiente:

• La primera sesión es la sesión padre o clonada: wAzIoF9Dqp4.
• A continuación de la palabra Clon: aparece la sessión clon con la que se está trabajando (N58G6Ur8Mv5 ). En este caso pidiendo un informe.
• A continuación aparece lo de siempre: usuario y mensaje.

De esta manera se puede seguir la traza de las sesiones y sus clones.

Reducción del tamaño de ficheros de log del Tomcat y la aplicación web

Con el servidor de aplicaciones Tomcat (servidor de java) existe dos ubicaciones para los ficheros de logs:

Los del Tomcat (servidor de aplicaciones java)

Normalmente en C:\apache-tomcat-8.5.50\logs . La configuración de los mismos se puede realizar directamente desde la consola de administración del servidor

C:\apache-tomcat-8.5.50\bin\tomcat8w.exe

• Ir al apartado loggin
• Seleccionar Level: Error

La aplicación web BOLD WEB / Portal del Empleado

Habitualmente en C:\apache-tomcat-8.5.50\boldweb\logs la configuración del volumen de información que se volcará se encuentra dentro del archivo ..\config\log.properties

Borrado programado de ficheros de LOGS

En las instalaciones estándar se programa un borrado de logs diario mediante una tarea programada. Ver las instrucciones en: https://gps-plan.com/ayuda/kgps/instalacion-del-portal