Changes between Initial Version and Version 1 of TranslationRu/TracLogging

Timestamp:

Oct 10, 2008, 8:04:48 PM (16 years ago)

Author:

anonymous

Comment:

—

TranslationRu/TracLogging

@@ +1 @@
+= Trac Logging =
+= Журнал в Trac =
+[[TracGuideToc]]
+
+En-Version: TracLogging
+
+Trac поддерживает ведение журнала системных сообщений, используя стандартный модуль для ведения журналов, поставляемый вместе с Python.
+
+Ведение журнала настраивается в секции `[logging]` в [wiki:TracIni#logging-section trac.ini].
+
+== Поддерживаемые методы ведения журнала ==
+
+Метод ведения журнала задается опцией `log_type` в [wiki:TracIni#logging-section trac.ini], которая может принимать следующие значения:
+
+ '''none''':: Скрывать все сообщения.
+ '''file''':: Сохранять сообщения в файл, имя которого задает опция `log_file` в [wiki:TracIni#logging-section trac.ini].
+ '''stderr''':: Выдавать все сообщения на консоль (только для [wiki:TracStandalone tracd]).
+ '''syslog''':: (UNIX) Посылать все сообщения локальной службе syslogd посредством конвейера `/dev/log`. По умолчанию syslog запишет сообщения в файл /var/log/messages.
+ '''eventlog''':: (Windows) Использовать системный NT Event Log для ведения журнала.
+
+== Уровни журнала ==
+
+Уровень подробности сообщений в журнале может быть задан опцией `log_level` в [wiki:TracIni#logging-section trac.ini]. Уровень подробности определяет минимальный уровень важности для сообщения, требуемый для попадания в журнал. Возможны следующие значения:
+
+ '''CRITICAL''':: Сохранять сообщения только о самых важных (фатальных) ошибках.
+ '''ERROR''':: Сохранять сообщения о отказах, сбоях и ошибках.
+ '''WARN''':: Сохранять предостережения о событиях не прерывающих работу.
+ '''INFO''':: Диагностическая информация, сохранять сообщения обо всех процессах.
+ '''DEBUG''':: Трассировочные сообщения, профилирование и т.д.
+
+== Формат журнала ==
+
+Начиная с Trac версии 0.10.4 (см. #2844) появилась возможность определять формат записей в журнале. Это можно сделать с помощью опции `log_format` в [wiki:TracIni#logging-section trac.ini]. Формат задается строкой, которая может содержать любые [http://docs.python.org/lib/node421.html переменные 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
+