Configure service logging

The Spotfire Statistics Services service generates logs containing information you can use to troubleshoot. You can set logging to different levels.

Spotfire Statistics Services uses log4j (http://logging.apache.org/log4j) as the primary logging mechanism for the service. The log files roll over, but by default only three are kept. (This default is configurable).

Other log files in SPSERVER_HOME/tomcat/logs occasionally generate Spotfire Statistics Services-related information but, in general, most information is written to SplusServer.log

The log levels provided bySpotfire Statistics Services are the standard log4j levels. In the case of Spotfire Statistics Services, these levels can be interpreted as follows:

Log Threshold Description
DEBUG Messages for troubleshooting/debugging purposes.
INFO Messages indicating the server is healthy and active.
WARN Messages indicating a potential issue.
ERROR Messages indicating an issue has occurred.
FATAL Messages indicating a catastrophic event has occurred.

Log Levels

The root logger is set to DEBUG by default. The default appender for the SplusServer.log file is labeled ROLLFILE. It has a default value of INFO for the logging threshold. To change this to DEBUG, for example, update the threshold to DEBUG:

log4j.appender.ROLLFILE.Threshold=DEBUG

For your convenience, the log4j.properties file includes brief documentation for the ROLLFILE appender and other commented-out appenders.

If you need assistance setting up one of these appenders, contact Spotfire support.

For information on engine logging, see configure engine logging.

Related concepts