syslog — Unix syslog 库例程 ¶

---

This module provides an interface to the Unix syslog library routines. Refer to the Unix manual pages for a detailed description of the syslog facility.

可用性 : Unix, not WASI, not iOS.

This module wraps the system syslog family of routines. A pure Python library that can speak to a syslog server is available in the logging.handlers module as SysLogHandler .

模块定义了下列函数：

syslog. syslog ( message ) ¶

syslog. syslog ( priority , message )

Send the string message to the system logger. A trailing newline is added if necessary. Each message is tagged with a priority composed of a facility 和 level 。可选 priority argument, which defaults to LOG_INFO , determines the message priority. If the facility is not encoded in priority using logical-or ( LOG_INFO | LOG_USER ), the value given in the openlog() call is used.

若 openlog() has not been called prior to the call to syslog() , openlog() will be called with no arguments.

引发 审计事件 syslog.syslog 采用自变量 priority , message .

3.2 版改变： In previous versions, openlog() would not be called automatically if it wasn’t called prior to the call to syslog() , deferring to the syslog implementation to call openlog() .

3.12 版改变： This function is restricted in subinterpreters. (Only code that runs in multiple interpreters is affected and the restriction is not relevant for most users.) openlog() must be called in the main interpreter before syslog() may be used in a subinterpreter. Otherwise it will raise RuntimeError .

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

Logging options of subsequent syslog() calls can be set by calling openlog() . syslog() 将调用 openlog() with no arguments if the log is not currently open.

可选 ident keyword argument is a string which is prepended to every message, and defaults to sys.argv[0] with leading path components stripped. The optional logoption keyword argument (default is 0) is a bit field – see below for possible values to combine. The optional facility keyword argument (default is LOG_USER ) sets the default facility for messages which do not have a facility explicitly encoded.

引发 审计事件 syslog.openlog 采用自变量 ident , logoption , facility .

3.2 版改变： In previous versions, keyword arguments were not allowed, and ident was required.

3.12 版改变： This function is restricted in subinterpreters. (Only code that runs in multiple interpreters is affected and the restriction is not relevant for most users.) This may only be called in the main interpreter. It will raise RuntimeError if called in a subinterpreter.