syslog — Обычные библиотечные процедуры syslog Unix

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

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

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

syslog.syslog(message)

syslog.syslog(priority, message)

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

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

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

Изменено в версии 3.2: В предыдущих версиях openlog() не вызывался автоматически, если он не был вызван до вызова syslog(), делегируя вызов openlog() реализации syslog.

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

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

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

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

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

syslog.closelog()

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

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

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

syslog.setlogmask(maskpri)

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

Вызывает событие аудита аудита 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...')