====== Ресурсы ======

  * [[https://py-repo.devel.a0fs.ru/|Дистрибутивы]]
  * [[https://repo.devel.a0fs.ru/py.lib.aw_log/|Исходный код]]

====== Общее описание ======

Процесс журналирования жизненного цикла приложения построен на [[.:api|общем API]], которое реализует различные [[.:loggers|каналы журналирования]]. В то же время, построение записи журнала примерно всегда одинаковое и состоит из:
  * //Префикса важности// - обозначает [[#Префикс_важности|уровень важности]] события, закодированный в одном символе.
  * //Идентификатор модуля// - идентификатор модуля приложения, являющегося источником события.
  * //Сообщение// - непосредственное описание произошедшего события.

В набор API включено средство замера времени выполнения некоторых операций. Средство может не обладать высокой точностью, однако явно покроет подавляющее количество потребностей в данном инструменте в рамках общих задач подобных измерений.

В качестве каналов журналирования реализованы:
  * ''SYSLOG(3)''
  * Файлы
  * Поток стандартного вывода и ошибок приложения

===== Префикс важности =====
^ Символ ^ Важность в терминах [[https://man.freebsd.org/cgi/man.cgi?query=syslog&sektion=3|SYSLOG(3)]] ^ Описание ^
|  ''`''  | ''LOG_DEBUG''   | Отладочные сообщения |
|  ''.''  | ''LOG_INFO''    | Информация. Основной уровень важности |
|  ''*''  | ''LOG_WARNING'' | События, являющиеся серьёзным сигналом о возможных проблемах с приложением. |
|  ''!''  | ''LOG_ERR''     | Ошибки приложения, явная деградация функционала всего приложения или его модуля |
|  ''#''  | ''LOG_ALERT''   | Отказ приложения или его модуля |


====== Подразделы ======

  * [[.:api|Общая часть API журналирования]]
  * [[.:timer|Объект таймера]]
  * [[.:loggers|Каналы журналирования]]