Logging

EDG generates several different logs:

The EDG log
The Tomcat access log
Other Tomcat logs

The EDG log

This is a general application log. It is located in the workspace directory (as specified in the The Setup File) under logs/edg.log. The latest log can also be downloaded via the EDG Log Admin Link.

EDG uses the Log4j logging library. As a result, the customer can set the log level, the format of the log, and the log file rotation policy.

The configuration files are in <CATALINA_BASE>/webapps/edg/WEB-INF/setupdata.

Note

For EDG Studio, these files are located in the conf subdirectory of the Studio download instead.

Configuring log file sizes and rotation policy

To configure the log file size and rotation policy, modify the EDG configuration file <CATALINA_BASE>/webapps/edg/WEB-INF/setupdata/log4j2-base.xml. Refer to the Log4j Appenders documentation for details.

Configuring log levels

To configure log levels, modify the EDG configuration file <CATALINA_BASE>/webapps/edg/WEB-INF/setupdata/log4j2-loggers.xml.

This file contains a Log4j <Loggers> configuration. It is described in detail here.

Here, the log level of certain “loggers” can be changed to enable or disable the logging of certain information. This is done by adding <Logger> elements:

<Logger name="loggername" level="LEVEL"/>

Supported levels are (from least to most information logged): OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE, ALL.

To enable verbose logging for all of TopBraid EDG, set the following loggers to ALL: org.topbraid, org.topbraidlive, com.topquadrant.
To enable the logging of failed HTTP requests to remote SPARQL endpoints (for Remote Data Support and SPARQL queries that use the SERVICE keyword), set the logger org.topbraid.sparql.RemoteSparqlLogger to ALL

The Tomcat access log

This is a web server access log that records all HTTP requests. It is maintained by Tomcat and usually located at <CATALINA_BASE>/logs/localhost_access_log.*.

Other Tomcat logs

Tomcat maintains a number of other logs that provide information on Tomcat’s setup and events or problems during EDG startup and shutdown. They are usually located at <CATALINA_BASE>/logs/catalina.*.log and <CATALINA_BASE>/logs/localhost.*.log.