cmlenz@39: = Trac Logging =
cmlenz@39: [[TracGuideToc]]
cmlenz@39: 
cmlenz@39: Trac supports logging of system messages using the standard [http://docs.python.org/lib/module-logging.html logging module] that comes with Python.
cmlenz@39: 
cmlenz@39: Logging is configured in the {{{[logging]}}} section in [wiki:TracIni trac.ini].
cmlenz@39: 
cmlenz@39: == Supported Logging Methods ==
cmlenz@39: 
cmlenz@39: The log method is set using the `log_type` configuration option, which takes any of the following values:
cmlenz@39:  '''none'':: Suppress all log messages.
cmlenz@39:  '''file''':: Log messages to a file, specified with the `log_file` option in [wiki:TracIni trac.ini]. 
cmlenz@39:  '''stderr''':: Output all log entries to console ([wiki:TracStandalone tracd] only).
cmlenz@39:  '''syslog''':: (UNIX) Send messages to local syslogd via named pipe `/dev/log`.
cmlenz@39:  '''eventlog''':: (Windows) Use the system's NT eventlog for Trac logging.
cmlenz@39: 
cmlenz@39: == Log Levels ==
cmlenz@39: 
cmlenz@39: The verbosity level of logged messages can be set using the ''log_level'' directive in [wiki:TracIni trac.ini]. The log level defines the minimum level of urgency required for a message to be logged.
cmlenz@39: 
cmlenz@39: The levels are:
cmlenz@39:  '''CRITICAL''':: Log only the most critical (typically fatal) errors.
cmlenz@39:  '''ERROR''':: Log failures, bugs and errors. 
cmlenz@39:  '''WARN''':: Log warnings, non-interrupting events.
cmlenz@39:  '''INFO''':: Diagnostic information, log information about all processing.
cmlenz@39:  '''DEBUG''':: Trace messages, profiling, etc.
cmlenz@39: 
cmlenz@39: ----
cmlenz@39: See also: TracIni, TracGuide, TracEnvironment