Edgewall Software

Changes between Initial Version and Version 1 of TranslationRu/TracLogging


Ignore:
Timestamp:
Oct 10, 2008, 8:04:48 PM (11 years ago)
Author:
anonymous
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • TranslationRu/TracLogging

    v1 v1  
     1= Trac Logging =
     2= Журнал в Trac =
     3[[TracGuideToc]]
     4
     5En-Version: TracLogging
     6
     7Trac поддерживает ведение журнала системных сообщений, используя стандартный модуль для ведения журналов, поставляемый вместе с Python.
     8
     9Ведение журнала настраивается в секции `[logging]` в [wiki:TracIni#logging-section trac.ini].
     10
     11== Поддерживаемые методы ведения журнала ==
     12
     13Метод ведения журнала задается опцией `log_type` в [wiki:TracIni#logging-section trac.ini], которая может принимать следующие значения:
     14
     15 '''none''':: Скрывать все сообщения.
     16 '''file''':: Сохранять сообщения в файл, имя которого задает опция `log_file` в [wiki:TracIni#logging-section trac.ini].
     17 '''stderr''':: Выдавать все сообщения на консоль (только для [wiki:TracStandalone tracd]).
     18 '''syslog''':: (UNIX) Посылать все сообщения локальной службе syslogd посредством конвейера `/dev/log`. По умолчанию syslog запишет сообщения в файл /var/log/messages.
     19 '''eventlog''':: (Windows) Использовать системный NT Event Log для ведения журнала.
     20
     21== Уровни журнала ==
     22
     23Уровень подробности сообщений в журнале может быть задан опцией `log_level` в [wiki:TracIni#logging-section trac.ini]. Уровень подробности определяет минимальный уровень важности для сообщения, требуемый для попадания в журнал. Возможны следующие значения:
     24
     25 '''CRITICAL''':: Сохранять сообщения только о самых важных (фатальных) ошибках.
     26 '''ERROR''':: Сохранять сообщения о отказах, сбоях и ошибках.
     27 '''WARN''':: Сохранять предостережения о событиях не прерывающих работу.
     28 '''INFO''':: Диагностическая информация, сохранять сообщения обо всех процессах.
     29 '''DEBUG''':: Трассировочные сообщения, профилирование и т.д.
     30
     31== Формат журнала ==
     32
     33Начиная с Trac версии 0.10.4 (см. #2844) появилась возможность определять формат записей в журнале. Это можно сделать с помощью опции `log_format` в [wiki:TracIni#logging-section trac.ini]. Формат задается строкой, которая может содержать любые [http://docs.python.org/lib/node421.html переменные Formatter из Python]. Дополнительно могут быть использованы специфичные для Trac переменные:
     34 '''$(basename)s''':: Последняя составляющая пути для текущей среды.
     35 '''$(path)s''':: Абсолютный путь для текущей среды.
     36 '''$(project)s''':: Имя создаваемого проекта.
     37
     38Замечание: для идентификации этих переменных используется знак доллара (`$(...)s`) вместо знака процента (`%(...)s`).
     39
     40Форматирование по-умолчанию:
     41{{{
     42log_format = Trac[$(module)s] $(levelname)s: $(message)s
     43}}}
     44
     45В средах со многими проектами когда весь журнал сохраняется в одном месте (например `syslog`) уместно добавить имя проекта. В этом примере мы используем `basename`, это как правило однозначно определяет проект:
     46{{{
     47log_format = Trac[$(basename)s:$(module)s] $(levelname)s: $(message)s
     48}}}
     49
     50----
     51Смотрите также: TracIni, TracGuide, TracEnvironment
     52