python syslog 接口_syslog (Unix) – Python 中文开发手册 - Break易站

Python 中文开发手册

syslog (Unix) - Python 中文开发手册

该模块为Unix syslog库例程提供了一个接口。请参阅Unix手册页以获取该syslog设施的详细说明。

该模块包装系统syslog系列的例程。可以与系统日志服务器对话的纯Python库在logging.handlers模块中可用SysLogHandler。

该模块定义了以下功能：

syslog.syslog(message)syslog.syslog(priority, message)

将字符串消息发送到系统记录器。 如有必要，可以添加尾随的换行符。 每条消息都标有由设施和级别组成的优先级。 可选的优先级参数(默认为LOG_INFO)决定了消息的优先级。 如果设施未使用逻辑或(LOG_INFO | LOG_USER)优先编码，则使用openlog()调用中给出的值。

如果在调用syslog()之前尚未调用openlog()，则将不带任何参数调用openlog()。

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

后续syslog()调用的日志记录选项可以通过调用openlog()来设置。 如果日志当前未打开，syslog()将会调用openlog()而不带参数。

可选的ident关键字参数是一个字符串，它被添加到每条消息中，并且默认为sys.argv [0]，其中剥离了前导路径组件。 可选的logoption关键字参数(默认值为0)是一个位字段 - 请参阅下面的可能值进行组合。 可选的facility关键字参数(默认值为LOG_USER)为没有明确编码设施的消息设置默认设施。

syslog.closelog()

重置系统日志模块值并调用系统库closelog()。

这会导致模块的行为与最初导入时的行为相同。 例如，将在第一个syslog()调用(如果尚未调用openlog())时调用openlog()，并将ident和其他openlog()参数重置为默认值。

syslog.setlogmask(maskpri)

将优先级掩码设置为maskpri并返回以前的掩码值。 以不在maskpri中设置的优先级调用syslog()将被忽略。 缺省是记录所有优先级。 函数LOG_MASK(pri)计算单个优先级pri的掩码。 函数LOG_UPTO(pri)为所有优先级(包括pri)计算掩码。

该模块定义了以下常量：

优先级(高到低)：LOG_EMERG，LOG_ALERT，LOG_CRIT，LOG_ERR，LOG_WARNING，LOG_NOTICE，LOG_INFO，LOG_DEBUG.Facilities：LOG_KERN，LOG_USER，LOG_MAIL，LOG_DAEMON，LOG_AUTH，LOG_LPR，LOG_NEWS，LOG_UUCP，LOG_CRON，LOG_SYSLOG和LOG_LOCAL0到LOG_LOCAL7。 日志选项：LOG_PID，LOG_CONS，LOG_NDELAY，LOG_NOWAIT和LOG_PERROR(如果在中定义的)。

1.例子

1.1 简单的例子

一组简单的例子：

import syslog

syslog.syslog('Processing started')

if error:

syslog.syslog(syslog.LOG_ERR, 'Processing started')

设置某些日志选项的示例，这些将​​包括日志消息中的进程ID，并将消息写入用于邮件日志记录的目标设施：

syslog.openlog(logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL)

syslog.syslog('E-mail processing initiated...')