Skip to main content

Pure python logging handler for writing logs to the journald using native protocol

Project description

logging-journald

PyPI - License Wheel PyPI PyPI Coverage Status tests

Pure python logging handler for writing logs to the journald using native protocol.

import logging
from logging_journald import JournaldLogHandler, check_journal_stream

# Use python default handler
LOG_HANDLERS = None


if (
    # Check if program running as systemd service
    check_journal_stream() or
    # Check if journald socket is available
    JournaldLogHandler.SOCKET_PATH.exists()
):
    LOG_HANDLERS = [JournaldLogHandler()]

logging.basicConfig(level=logging.INFO, handlers=LOG_HANDLERS)
logging.info("Hello logging world.")

MESSAGE_ID field

As defined in catalog documentation:

A 128-bit message identifier ID for recognizing certain message types, if this is desirable. This should contain a 128-bit ID formatted as a lower-case hexadecimal string, without any separating dashes or suchlike. This is recommended to be a UUID-compatible ID, but this is not enforced, and formatted differently. Developers can generate a new ID for this purpose with systemd-id128 new.

So you're free to choose how you want to act. By default, MESSAGE_ID is generated as a hash of the message and some static fields. But you can disable this by passing use_message_id=False to the class constructor.

from logging_journald import JournaldLogHandler

...

handler = JournaldLogHandler(use_message_id=False)

...

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

logging_journald-0.6.9.tar.gz (5.4 kB view details)

Uploaded Source

Built Distribution

logging_journald-0.6.9-py3-none-any.whl (5.6 kB view details)

Uploaded Python 3

File details

Details for the file logging_journald-0.6.9.tar.gz.

File metadata

  • Download URL: logging_journald-0.6.9.tar.gz
  • Upload date:
  • Size: 5.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.11.7 Darwin/23.5.0

File hashes

Hashes for logging_journald-0.6.9.tar.gz
Algorithm Hash digest
SHA256 f4b242de387e24509e8dd490eac7980f98e2f82b259581d2c5936e1b477ec126
MD5 f845951fd4e0194f7568b210c5f53b24
BLAKE2b-256 d1b8c7a0de68c9083862802770695affede953acef501a8809df4fbf83c2551a

See more details on using hashes here.

File details

Details for the file logging_journald-0.6.9-py3-none-any.whl.

File metadata

File hashes

Hashes for logging_journald-0.6.9-py3-none-any.whl
Algorithm Hash digest
SHA256 c3078b5db5e3e94a75fbf624d3255b3dfbf0bcbde7f36bad77271a7422acd0b0
MD5 d565b5b9be5ee56f960d536d1715319f
BLAKE2b-256 715a9f646db32e009d3a866d64f89c636ee8c22fd104cf923540dc35ecac961d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page