Edgewall Software

Version 4 (modified by jacob@…, 18 years ago) ( diff )

Added note about using the logging package with Python 2.2

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 part of Python 2.3 and newer. Warning: If you are using a version of Python older than 2.3, log messages will be silently thrown away!

If you are using Python 2.2, however, note that the logging package works perfectly under 2.2; you can just copy the entire logging directory from the Python 2.3 lib directory into the Python 2.2 lib directory.

Supported Methods

  • none — Suppress all log messages.
  • file — Log messages to a file, specified in the configuration (Using the log_file directive in trac.ini).
  • stderr — Output all log entries to console. (tracd only)
  • syslog — (UNIX) Send messages to local syslogd via named pipe '/dev/log'.
  • winlog — (Windows) Use the system's NT eventlog for Trac logging.

Log Levels

The level of verbosity 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, messages.
  • ERROR — Request failures, bugs and errors.
  • WARN — Warnings, non-interrupting events.
  • INFO — Diagnostic information, log information about all requests.
  • DEBUG — Development messages, profiling, etc. Not for public consumption.

See also: TracIni, TracGuide

Note: See TracWiki for help on using the wiki.