Logging

TQ Data Foundation generates several different logs:

The Application 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 :ref:`DownloadApplicationLogAdminLink`option.

TQ Data Foundation 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 Data Foundation 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 Data Foundation 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 TQ Data Foundation, 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.*.

See also: Configuring Tomcat for TQ Data Foundation

Other Tomcat logs

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