| | 1 | = Trac Logging = |
| | 2 | Trac supports logging of system messages using the standard ''logging'' module part of Python 2.3 and newer. |
| | 3 | |
| | 4 | == Supported Methods == |
| | 5 | * '''none''' -- Suppress all log messages. |
| | 6 | * '''file''' -- Log messages to a file, specified in the [wiki:TracConfiguration configuration] (Using the ''log_file'' directive in [wiki:TracIni trac.ini]). |
| | 7 | * '''stderr''' -- Output all log entries to console. (tracd only) |
| | 8 | * '''syslog''' -- (UNIX) Send messages to local syslogd via named pipe '/dev/log'. |
| | 9 | * '''winlog''' -- (Windows) Use the system's NT eventlog for Trac logging. |
| | 10 | |
| | 11 | == Log Levels == |
| | 12 | The level of verbosity 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. |
| | 13 | |
| | 14 | The levels are: |
| | 15 | * ''CRITICAL'' -- Log only the most critical, typically fatal, messages. |
| | 16 | * ''ERROR'' -- Request failures, bugs and errors. |
| | 17 | * ''WARN'' -- Warnings, non-interrupting events. |
| | 18 | * ''INFO'' -- Diagnostic information, log information about all requests. |
| | 19 | * ''DEBUG'' -- Development messages, profiling, etc. Not for public consumption. |
| | 20 | |
| | 21 | ---- |
| | 22 | See also: TracIni, TracGuide |
