Last modified 16 months ago Last modified on Sep 17, 2018, 4:52:37 PM

Trac Logging


Logging is configured in the [logging] section in trac.ini.

Supported Logging Methods


Suppress all log messages.
Log messages to a file, specified with the log_file option in trac.ini. Relative paths in log_file are resolved relative to the log directory of the environment.
Output all log entries to console (tracd only).

Log Levels


Log only the most critical (typically fatal) errors.
Log failures, bugs and errors.
Log warnings, non-interrupting events.
Diagnostic information, log information about all processing.
Trace messages, profiling, etc.

Additionally, you can enable logging of SQL statements at debug level. This is turned off by default, as it's very verbose. Set [trac] debug_sql = yes in TracIni to activate.

Log Format

The output format for log entries can be specified through the log_format option in trac.ini. The format is a string which can contain any of the Python logging Formatter variables. Additonally, the following Trac-specific variables can be used:

The last path component of the current environment.
The absolute path for the current environment.
The originating project's name.


The default format is:




See also: TracIni, TracGuide, TracEnvironment