^{from version 1.5}

The inspectIT uses the Logback as the logging framework. This page describes the possibilities a user has to control the logging output of inspectIT components.

Default configuration

Each project defines the default logging configuration in the [ROOT]/logging-config.xml file. This is the default configuration that will be used. This file can be changed by the user to enable/disable different levels of logging for different components.

By default the inspectIT components log on the INFO level, while the 3rd party libraries are configured to log only the ERROR level.

Log files

By default all the files created by the logging are placed in the [ROOT]/logs folder. Note that in case of the Agent, root folder is considered to be one where inspectit-agent.jar is located. Here is the overview of the files created and their content:

File	Content	Rollover policy	Max file size	Max history
CMR
logs/cmr.log	Contains the same output as the console.	Daily	20MB	30 days
logs/exceptions.log	Contains only the exceptions that were logged.	Daily	20MB	30 days
logs/statistic.log	Contains the CMR usage and health statistics.	Daily	20MB	30 days
inspectIT UI
logs/inspectit.log	Contains the same output as the console.	Daily	20MB	30 days
logs/exceptions.log	Contains only the exceptions that were logged.	Daily	20MB	30 days
Agent
logs/agent_name/agent.log	Contains the same output as the console but only related to inspectIT Agent. This file can contain more information than the ones outputted to console.	Daily	20MB	30 days
logs/agent_name/exceptions.log	Contains only the exceptions that were logged only by inspectIT Agent.	Daily	20MB	30 days

Agent logs are additionally organized in sub-folders named as the Agent name in the configuration. This is done in order to correctly separate logs from different Agents that might point to the same inspectit-agent.jar file.

These files can be deleted at any time if you want to save the hard disc space.

Pointing to external log configuration file

It is also possible to point to the external log configuration file custom defined by the user. This can be done by defining the -Dinspectit.logging.config property that will point to the file. For example:

-Dinspectit.logging.config=/home/user/myLogConfig.xml

Please note that the file must contain a valid Logback configuration.