| |
1 |
= Trac Logging = |
| |
2 |
[[TracGuideToc]] |
| |
3 |
|
| |
4 |
Trac supports logging of system messages using the standard ''logging'' module part of Python 2.3 and newer. |
| |
5 |
|
| |
6 |
'''Note:''' If you are using a Python version older than 2.3, the Trac logging mechanism will be silently disabled. |
| |
7 |
|
| |
8 |
Logging is configured in the {{{[logging]}}} section in [wiki:TracIni trac.ini]. |
| |
9 |
|
| |
10 |
== Python 2.2 Workaround == |
| |
11 |
If you are using Python 2.2, however, note that the logging package from Python 2.3 works perfectly under 2.2 as well; you can just copy the entire {{{logging}}} directory from the Python 2.3 library into the Python 2.2 lib directory. Perhaps not the most elegant solution, but it works. |
| |
12 |
|
| |
13 |
|
| |
14 |
== Supported Logging Methods == |
| |
15 |
* '''none''' -- Suppress all log messages. |
| |
16 |
* '''file''' -- Log messages to a file, specified with the ''log_file'' directive in [wiki:TracIni trac.ini]. |
| |
17 |
* '''stderr''' -- Output all log entries to console ([wiki:TracStandalone tracd] only). |
| |
18 |
* '''syslog''' -- (UNIX) Send messages to local syslogd via named pipe '/dev/log'. |
| |
19 |
* '''winlog''' -- (Windows) Use the system's NT eventlog for Trac logging. |
| |
20 |
|
| |
21 |
== Log Levels == |
| |
22 |
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. |
| |
23 |
|
| |
24 |
The levels are: |
| |
25 |
* ''CRITICAL'' -- Log only the most critical, typically fatal, messages. |
| |
26 |
* ''ERROR'' -- Request failures, bugs and errors. |
| |
27 |
* ''WARN'' -- Warnings, non-interrupting events. |
| |
28 |
* ''INFO'' -- Diagnostic information, log information about all requests. |
| |
29 |
* ''DEBUG'' -- Development messages, profiling, etc. Not fit for human consumption. |
| |
30 |
|
| |
31 |
---- |
| |
32 |
See also: TracIni, TracGuide, TracEnvironment |
