Changes between Initial Version and Version 1 of TracLogging

Sep 23, 2005, 2:43:11 AM (15 years ago)


  • TracLogging

    v1 v1  
     1= Trac Logging =
     4Trac supports logging of system messages using the standard ''logging'' module part of Python 2.3 and newer.
     6'''Note:''' If you are using a Python version older than 2.3, the Trac logging mechanism will be silently disabled.
     8Logging is configured in the {{{[logging]}}} section in [wiki:TracIni trac.ini].
     10== Python 2.2 Workaround ==
     11If 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.
     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.
     21== Log Levels ==
     22The 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.
     24The 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.
     32See also: TracIni, TracGuide, TracEnvironment