Changes between Version 3 and Version 4 of TracLogging

Ignore:
Timestamp:
01/14/19 00:01:55 (2 years ago)
Comment:

--

Legend:

Unmodified
 v3 = Trac Logging = = Trac Logging [[TracGuideToc]] Logging is configured in the [logging] section in [wiki:TracIni#logging-section trac.ini]. == Supported Logging Methods == == Supported Logging Methods The log method is set using the log_type option in [wiki:TracIni#logging-section trac.ini], which takes any of the following values: '''eventlog''':: (Windows) Use the system's NT Event Log for Trac logging. == Log Levels == == Log Levels The verbosity level of logged messages can be set using the log_level option in [wiki:TracIni#logging-section trac.ini]. The log level defines the minimum level of urgency required for a message to be logged, and those levels are: '''DEBUG''':: Trace messages, profiling, etc. Note that starting with Trac 0.11.5 you can in addition enable logging of SQL statements, at debug level. This is turned off by default, as it's very verbose (set [trac] debug_sql = yes in TracIni to activate). Additionally, you can  enable logging of SQL statements at debug level. This is turned off by default, as it's very verbose. Set [trac] debug_sql = yes in TracIni to activate. == Log Format == == Log Format Starting with Trac 0.10.4 (see [trac:#2844 #2844]), it is possible to set the output format for log entries. This can be done through the log_format option in [wiki:TracIni#logging-section trac.ini]. The format is a string which can contain any of the [http://docs.python.org/library/logging.html#logrecord-attributes Python logging Formatter variables]. Additonally, the following Trac-specific variables can be used: The output format for log entries can be specified through the log_format option in [wiki:TracIni#logging-section trac.ini]. The format is a string which can contain any of the [http://docs.python.org/library/logging.html#logrecord-attributes Python logging Formatter variables]. Additonally, the following Trac-specific variables can be used: '''$(basename)s''':: The last path component of the current environment. '''$(path)s''':: The absolute path for the current environment. The default format is: {{{ {{{#!ini log_format = Trac[$(module)s]$(levelname)s: $(message)s }}} In a multi-project environment where all logs are sent to the same place (e.g. syslog), it makes sense to add the project name. In this example we use basename since that can generally be used to identify a project: {{{ {{{#!ini log_format = Trac[$(basename)s:$(module)s]$(levelname)s: \$(message)s }}}