syslog — Рoutines библиотеки Unix syslog

Этот модуль предоставляет интерфейс к функциям библиотеки Unix syslog. Обратитесь к страницам руководства Unix для подробного описания syslog объекта.

Этот модуль оборачивает семейство системных функций syslog. Чистая Python-библиотека, которая может взаимодействовать с сервером syslog, доступна в модуле logging.handlers как SysLogHandler.

Модуль определяет следующие функции:

syslog.syslog(message)

syslog.syslog(priority, message)

Отправляет строку message в системный регистратор. Треллинг-новая строка добавляется при необходимости. Каждое сообщение помечено приоритетом, состоящим из facility и level. Необязательный аргумент priority, который по умолчанию равен LOG_INFO, определяет приоритет сообщения. Если facility не закодирован в priority с использованием логического ИЛИ (LOG_INFO | LOG_USER), используется значение, заданное в вызове openlog().

Если openlog() не был вызван до вызова syslog(), openlog() будет вызван без аргументов.

Возбуждает событие аудита auditing event syslog.syslog с аргументами priority, message.

syslog.openlog([ident[, logoption[, facility]]])

Параметры регистрации последующих вызовов syslog() могут быть установлены путем вызова openlog(). syslog() вызовет openlog() без аргументов, если журнал в настоящее время не открыт.

Необязательный аргумент ident — это строка, которая предшествует каждому сообщению, и по умолчанию равна sys.argv[0] с удаленными начальными компонентами пути. Необязательный аргумент logoption (значение по умолчанию 0) — это битовое поле — см. ниже возможные значения для объединения. Необязательный аргумент facility (значение по умолчанию LOG_USER) устанавливает значение по умолчанию для сообщений, которые не имеют явно закодированного facility.

Возбуждает событие аудита auditing event syslog.openlog с аргументами ident, logoption, facility.

Изменено в версии 3.2: В предыдущих версиях ключевые аргументы не допускались, а ident был обязательным. Значение по умолчанию для ident зависело от системных библиотек и часто было python вместо имени файла программы Python.

syslog.closelog()

Сбросьте значения модуля syslog и вызовите системную библиотеку closelog().

Это заставляет модуль вести себя так, как он ведет себя при первоначальном импорте. Например, openlog() будет вызван при первом вызове syslog() (если openlog() еще не был вызван), а параметры ident и другие параметры openlog() сбрасываются до значений по умолчанию.

Возбуждает событие аудита auditing event syslog.closelog без аргументов.

syslog.setlogmask(maskpri)

Установите маску приоритета на maskpri и верните предыдущее значение маски. Вызовы syslog() с уровнем приоритета, не установленным в maskpri, игнорируются. По умолчанию регистрируются все приоритеты. Функция LOG_MASK(pri) вычисляет маску для отдельного приоритета pri. Функция LOG_UPTO(pri) вычисляет маску для всех приоритетов до и включая pri.

Возбуждает событие аудита auditing event syslog.setlogmask с аргументом maskpri.

Модуль определяет следующие константы:

Уровни приоритетов (с высоких к низким):

LOG_EMERG, LOG_ALERT, LOG_CRIT, LOG_ERR, LOG_WARNING, LOG_NOTICE, LOG_INFO, LOG_DEBUG.

Области:

LOG_KERN, LOG_USER, LOG_MAIL, LOG_DAEMON, LOG_AUTH, LOG_LPR, LOG_NEWS, LOG_UUCP, LOG_CRON, LOG_SYSLOG, LOG_LOCAL0 до LOG_LOCAL7, и, если определено в <syslog.h>, LOG_AUTHPRIV.

Параметры журнала:

LOG_PID, LOG_CONS, LOG_NDELAY, и, если определено в <syslog.h>, LOG_ODELAY, LOG_NOWAIT, и LOG_PERROR.

import syslog

syslog.syslog('Processing started')
if error:
    syslog.syslog(syslog.LOG_ERR, 'Processing started')

syslog.openlog(logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL)
syslog.syslog('E-mail processing initiated...')