This page documents the 1.4 (latest stable) release. Documentation for other releases can be found here.

Trac Logging

Trac supports logging of system messages using the standard ​logging module that comes with Python.

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

Supported Logging Methods

The log method is set using the log_type option in trac.ini, which takes any of the following values:

none

Suppress all log messages.

file

Log messages to a file, specified with the log_file option in trac.ini.

stderr

Output all log entries to console (tracd only).

syslog

(UNIX) Send messages to local syslogd via named pipe /dev/log.

eventlog

(Windows) Use the system's NT eventlog for Trac logging.

Log Levels

The verbosity level of logged messages can be set using the log_level option in trac.ini. The log level defines the minimum level of urgency required for a message to be logged, and those levels are:

CRITICAL

Log only the most critical (typically fatal) errors.

ERROR

Log failures, bugs and errors.

WARN

Log warnings, non-interrupting events.

INFO

Diagnostic information, log information about all processing.

DEBUG

Trace messages, profiling, etc.

---

See also: TracIni, TracGuide, TracEnvironment