An up-to-date, RFC5424-Compliant syslog handler for the Python logging framework
Project description
An up-to-date, RFC 5424 compliant syslog handler for the Python logging framework.
Free software: BSD License
Documentation: http://rfc5424-logging-handler.readthedocs.org/
Features
RFC 5424 Compliant.
Python Logging adapter for easier sending of rfc5424 specific fields.
No need for complicated formatting strings.
TLS/SSL syslog support.
Installation
Python package:
pip install rfc5424-logging-handler
Usage
After installing you can use this package like this:
import logging
from rfc5424logging import Rfc5424SysLogHandler
logger = logging.getLogger('syslogtest')
logger.setLevel(logging.INFO)
sh = Rfc5424SysLogHandler(address=('10.0.0.1', 514))
logger.addHandler(sh)
logger.info('This is an interesting message', extra={'msgid': 'some_unique_msgid'})
This will send the following message to the syslog server:
<14>1 2020-01-01T05:10:20.841485+01:00 myserver syslogtest 5252 some_unique_msgid - \xef\xbb\xbfThis is an interesting message
Note the UTF8 Byte order mark (BOM) preceding the message. While required by RFC 5424 section 6.4 if the message is known to be UTF-8 encoded, there are still syslog receivers that cannot handle it. To bypass this limitation, when initializing the handler Class, set the msg_as_utf8 parameter to False like this:
sh = Rfc5424SysLogHandler(address=('10.0.0.1', 514), msg_as_utf8=False)
For more examples, have a look at the documentation
Changelog
1.2.1 - 2018/09/21
Fixed
#21 Registered structured data IDs where also suffixed with an enterprise ID.
Added
#22 Add utc_timestamp parameter to allow logging in UTC time.
1.1.2 - 2018/02/03
Fixed
1.1.1 - 2017/12/08
Fixed
#14 Fixed handling of extra parameter in logging adapter.
1.1.0 - 2017/11/24
Added
The msg parameter for the logger handler can now be absent allowing “structured data only” messages.
Fixed
Correct the automatic value of the hostname when the value is anything other then NILVALUE
The syslog message is now empty in conformance with RFC5424 when it’s value is None or an empty string.
1.0.3 - 2017/10/08
No functional changes. Only documentation was changed.
Added
Logstash configuration example for RFC5424.
Changed
Moved most of the documentation out of the readme file.
1.0.2 - 2017/08/31
Fixed
Package description rendering on PyPi due to bug pypa/wheel#189
1.0.1 - 2017/08/30
Added
1.0.0 - 2017/05/30
Changed
#10: Procid, appname and hostname can now be set per message, both with the handler as well as with the adapter
0.2.0 - 2017/01/27
Fixed
Better input handling
Better sanitizing of invalid input
0.1.0 - 2017/01/22
Added
#4: Adapter class to make it easier to log message IDs or structured data
Logging of EMERGENCY, ALERT and NOTICE syslog levels by using the adapter class
Extensive test suite
0.0.2 - 2017/01/18
Added
#5 Introduced Python 2.7 compatibility
0.0.1 - 2017/01/11
Initial release
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for rfc5424-logging-handler-1.3.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | adb2228ada491ae3e83f6840768d9818763dffca506275abb03ecd5caf5b2a64 |
|
MD5 | 231196aa54acc65642048a868273a19e |
|
BLAKE2b-256 | 82bbf8807d620c97e105f03fe05f058a687116045dd21e22de7fda2af5bc924d |
Hashes for rfc5424_logging_handler-1.3.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8c944b5361df53186c99723ed473c4c240def85fb13f4dcd69151baa4a9cbdda |
|
MD5 | 883f2de0fdea8ec7bd10d74380b53916 |
|
BLAKE2b-256 | 59a741f715ac01774045308baa1192ab420965977186194339f7f2a2a3a86338 |