wiki:TracLogging

Version 2 (modified by trac, 10 years ago) (diff)

--

The TracGuide is not editable on this site. Changes should instead be made on the Trac Development site.

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 configuration option, 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 directive in trac.ini. The log level defines the minimum level of urgency required for a message to be logged.

The 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