Configuración de Logging (2.x) (es_ES)

Una vez Sakai está instalado, configurado y puesto en marcha, se puede monitorizar Sakai analizando los ficheros de log. El nivel de log para el Sakai estándar (en el código fuente y en la demo) es de "info" y "warnings". Vigila los mensajes "WARN:". Aparecerán algunos "normales" al arrancar Sakai y algunos podrían salir durante el tiempo que está en marcha, pero cualquier warning puede ser potencialmente algo que podrías necesitar chequear..

Los niveles de logging pueden especificarse en sakai.properties. Esto sobreescribe los niveles definidos en el fichero sakai.properties por defecto. Ejemplo:

log.config.count=3
log.config.1 = ALL.org.sakaiproject.log.impl
log.config.2 = OFF.org.sakaiproject
log.config.3 = DEBUG.org.sakaiproject.db.impl

Esto usa el método de tener un name.count seguido de name.1, name.2 etc. para crear un array de stings para el valor de "name". En este caso, el "name" es "log.config". Los valores están en la forma LEVEL.logger, y los posibles niveles son : OFF TRACE DEBUG INFO WARN ERROR FATAL ALL.

Sakai usa log4j para el logging. Es recomendable ver la documentación oficial de log4j para más información acerca de esta configuración, aunque a continuación damos algunos consejos.

Para cambiar el logging de Sakai en el código fuente hay que modificar kernel/kernel-common/src/main/config/log4j.properties y cambiar al siguiente propiedad:

log4j.logger.org.sakaiproject=INFO

Para poner por defecto el logging a nivel DEBUG en Sakai hay que cambiar el valor de INFO a DEBUG. Para hacerlo para un único componente de Sakai, hay que añadir una línea como la del siguiente ejemplo en la que se deja todo el logging de Sakai en INFO excepto para el servicio de SQL service que queda en modo DEBUG:

log4j.logger.org.sakaiproject=INFO
log4j.logger.org.sakaiproject.component.framework.sql.BasicSqlService=DEBUG

Los controles de logging son parte del LogConfigurationManager, implementado como componente en el Kernel. Puede ser deshabilitado, si se desea, con una entrada en el  sakai.properties:

enabled@org.sakaiproject.log.api.LogConfigurationManager = false

Para Mac y *nix , el log más importante se encuentra en la carpeta de Tomcat:  logs/catalina.out. Puede ser muy instructivo vigilar este log mientras Tomcat arranca usando un comando como el siguiente:

bin/startup.sh; tail -f logs/catalina.out

Tomcat en Windows tiende a ser un poco más complicado para el tema de los logs, e incluye más de uno. su comportamiento por defecto es abrir  catalina.out en una nueva ventana en el momento en que arrancas Tomcat. Si necesitas más información sobre los logs en Windows, lo mejor es mirar la documentación oficial de Tomcat al respecto.

Los logs del servidor SMTP de Sakai se escribirán en el directorio $CATALINA_HOME/sakai/logs.