annotate examples/trac/wiki-default/TracLogging @ 60:2cb5b54d87ff trunk

Migrate attachment templates to Markup.
author cmlenz
date Wed, 05 Jul 2006 21:32:27 +0000
parents 93b4dcbafd7b
children
rev   line source
39
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
1 = Trac Logging =
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
2 [[TracGuideToc]]
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
3
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
4 Trac supports logging of system messages using the standard [http://docs.python.org/lib/module-logging.html logging module] that comes with Python.
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
5
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
6 Logging is configured in the {{{[logging]}}} section in [wiki:TracIni trac.ini].
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
7
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
8 == Supported Logging Methods ==
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
9
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
10 The log method is set using the `log_type` configuration option, which takes any of the following values:
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
11 '''none'':: Suppress all log messages.
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
12 '''file''':: Log messages to a file, specified with the `log_file` option in [wiki:TracIni trac.ini].
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
13 '''stderr''':: Output all log entries to console ([wiki:TracStandalone tracd] only).
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
14 '''syslog''':: (UNIX) Send messages to local syslogd via named pipe `/dev/log`.
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
15 '''eventlog''':: (Windows) Use the system's NT eventlog for Trac logging.
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
16
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
17 == Log Levels ==
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
18
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
19 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.
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
20
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
21 The levels are:
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
22 '''CRITICAL''':: Log only the most critical (typically fatal) errors.
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
23 '''ERROR''':: Log failures, bugs and errors.
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
24 '''WARN''':: Log warnings, non-interrupting events.
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
25 '''INFO''':: Diagnostic information, log information about all processing.
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
26 '''DEBUG''':: Trace messages, profiling, etc.
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
27
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
28 ----
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
29 See also: TracIni, TracGuide, TracEnvironment
Copyright (C) 2012-2017 Edgewall Software