Edgewall Software

Changes between Initial Version and Version 1 of 0.12/TranslationRu/TracLogging


Ignore:
Timestamp:
Jul 16, 2012, 9:22:15 PM (9 years ago)
Author:
trac
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • 0.12/TranslationRu/TracLogging

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