Edgewall Software

Trac Logging

Журнал в Trac

На других языках:

Trac поддерживает ведение журнала системных сообщений, используя стандартный модуль для ведения журналов, поставляемый вместе с Python.

Ведение журнала настраивается в секции [logging] в trac.ini.

Поддерживаемые методы ведения журнала

Метод ведения журнала задается опцией log_type в trac.ini, которая может принимать следующие значения:

none
Скрывать все сообщения.
file
Сохранять сообщения в файл, имя которого задает опция log_file в trac.ini.
stderr
Выдавать все сообщения на консоль (только для tracd).
syslog
(UNIX) Посылать все сообщения локальной службе syslogd посредством конвейера /dev/log. По умолчанию syslog запишет сообщения в файл /var/log/messages.
eventlog
(Windows) Использовать системный NT Event Log для ведения журнала.

Уровни журнала

Уровень подробности сообщений в журнале может быть задан опцией log_level в trac.ini. Уровень подробности определяет минимальный уровень важности для сообщения, требуемый для попадания в журнал. Возможны следующие значения:

CRITICAL
Сохранять сообщения только о самых важных (фатальных) ошибках.
ERROR
Сохранять сообщения о отказах, сбоях и ошибках.
WARN
Сохранять предостережения о событиях не прерывающих работу.
INFO
Диагностическая информация, сохранять сообщения обо всех процессах.
DEBUG
Трассировочные сообщения, профилирование и т.д.

Формат журнала

Начиная с Trac версии 0.10.4 (см. #2844) появилась возможность определять формат записей в журнале. Это можно сделать с помощью опции log_format в trac.ini. Формат задается строкой, которая может содержать любые переменные Formatter из Python. Дополнительно могут быть использованы специфичные для Trac переменные:

$(basename)s
Последняя составляющая пути для текущей среды.
$(path)s
Абсолютный путь для текущей среды.
$(project)s
Имя создаваемого проекта.

Замечание: для идентификации этих переменных используется знак доллара ($(...)s) вместо знака процента (%(...)s).

Форматирование по-умолчанию:

log_format = Trac[$(module)s] $(levelname)s: $(message)s

В средах со многими проектами когда весь журнал сохраняется в одном месте (например syslog) уместно добавить имя проекта. В этом примере мы используем basename, это как правило однозначно определяет проект:

log_format = Trac[$(basename)s:$(module)s] $(levelname)s: $(message)s

Смотрите также: TracIni, TracGuide, TracEnvironment

Last modified 6 years ago Last modified on Feb 2, 2011, 11:08:17 AM
Note: See TracWiki for help on using the wiki.