loggerglue.logger — Convenience class for logging RFC5424-formatted messages

An rfc5424/rfc5425 syslog server implementation Copyright © 2011 Evax Software <contact@evax.fr>

class loggerglue.logger.Logger(emitter=None, hostname=None, app_name=None, procid=None)

Bases: object

Convenience class to log RFC5424 messages to the local syslog daemon (by default) or a remote syslog receiver.

Arguments

emitter

Emitter object to send syslog messages, default to Unix socket /dev/log

hostname

Hostname to send with log messages, defaults to system hostname

app_name

Application name to send with log messages, defaults to application name

procid

Process ID to send with log messages, default to current process ID

close()

Close connection to logger.

log(msg=None, msgid=None, structured_data=None, prival=14, timestamp=None)

Log a message.

Example:

>>> logger.log("test", prival=LOG_DEBUG|LOG_MAIL)

Arguments

msg

Human readable message to log

msgid

Message identifier

structured_data

Structured data to attach to log message

prival

Priority and facility of message (defaults to INFO|USER)

timestamp

UTC time of log message (default to current time)