Web Dashboard logs and troubleshooting

By default, Web Dashboard log entries are written into the Tomcat console or the catalina.<date>.log file (for example, catalina.2014-01-10.log) available in <WEB_SERVER_HOME>/logs directory, where <WEB_SERVER_HOME> represents the absolute path to the home directory of your web server. Logs are managed using log4j and by default only messages with the following levels are logged: INFO, WARN, ERROR and FATAL.

To troubleshoot the application, create a file named log4j.xml and place it in the <WEB_SERVER_HOME>/webapps/SentinelWebDashboard/WEB-INF/classes directory. Restart Tomcat or reload the Sentinel Web Dashboard web application via the Tomcat Application Manager to ensure this file is considered.

In the example below, logging is redirected to a dedicated file called SentinelWebDashboard.log and log level is adjusted to DEBUG. To use this example, you must replace <WEB_SERVER_HOME> with the absolute path to your web server's home directory, for example, C:/Axway/Sentinel/Tools/apache-tomcat.

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">

<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/" debug="false">

<appender name="FILE" class="org.apache.log4j.RollingFileAppender">

<param name="File" value="<WEB_SERVER_HOME>/logs/SentinelWebDashboard.log"/>

<layout class="org.apache.log4j.PatternLayout">

<param name="ConversionPattern" value="%d %-5p \[%t\] %C{2} (%F:%L) - %m%n"/>

</layout>

</appender>

<root>

<priority value="DEBUG"/>

<appender-ref ref="FILE"/>

</root>

</log4j:configuration>

For information about how to create your custom log, visit http://logging.apache.org/log4j/1.2/.

Related Links