Skip to content
Simplifies logging for systemd
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
demo init_systemd_logging() now tries to detect systemd and returns boolean. Jan 28, 2020
docs
systemdlogging Release v0.3.0 Jan 28, 2020
tests init_systemd_logging() now tries to detect systemd and returns boolean. Jan 28, 2020
.coveragerc Start here. Oct 14, 2019
.gitignore
.travis.yml Start here. Oct 14, 2019
AUTHORS
CHANGELOG Release v0.3.0 Jan 28, 2020
CONTRIBUTING
INSTALL Start here. Oct 14, 2019
LICENSE Years updated. Jan 28, 2020
MANIFEST.in Start here. Oct 14, 2019
README.rst Typo fix. Jan 28, 2020
setup.cfg Start here. Oct 14, 2019
setup.py Start here. Oct 14, 2019
tox.ini

README.rst

systemd-logging

https://github.com/idlesign/systemd-logging

release lic ci coverage

Description

Simplifies logging for systemd

Requires Python 3.6+

  • No need to compile (pure Python), uses libsystemd.so.
  • Simplified configuration.
  • Just logging. Nothing more.

Usage

import logging

from systemdlogging.toolbox import init_systemd_logging

# This one line in most cases would be enough.
# By default it attaches systemd logging handler to a root Python logger.
init_systemd_logging()  # Returns True if initialization went fine.

# Now you can use logging as usual.
logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)

logger.debug('My debug message')

try:
    raise ValueError('Log me please')

except ValueError:
    # Additional context can be passed in extra.context.
    logger.exception('Something terrible just happened', extra={
        'message_id': True,  # Generate message ID automatically.
        'context': {
            'FIELD1': 'one',
            'FIELD2': 'two',
        }
    }, stack_info=True)

Read the docs to find out more.

Documentation

https://systemd-logging.readthedocs.org/

You can’t perform that action at this time.