stogger.systemd

stogger.systemd — systemd journal I/O for stogger.

Lazy-loaded: only imported when systemd journal integration is enabled. Uses only stdlib (socket, stat, pathlib) — no external dependencies.

Attributes

JOURNAL_SOCKET_PATH

Classes

JournalSender	Send structured messages to the systemd journal via AF_UNIX socket.
JournalLogger	Write log messages to the systemd journal via AF_UNIX socket.
DummyJournalLogger	No-op journal logger for non-systemd environments.
JournalLoggerFactory	Creates JournalLogger or DummyJournalLogger based on systemd availability.

Functions

get_journal_logger_factory()

Return a JournalLoggerFactory instance.

Module Contents

stogger.systemd.JOURNAL_SOCKET_PATH = '/run/systemd/journal/socket'

class stogger.systemd.JournalSender(socket_path=JOURNAL_SOCKET_PATH)

Send structured messages to the systemd journal via AF_UNIX socket.

Parameters:

socket_path (str)

send(fields)

Parameters:

fields (dict)

Return type:

bool

static format_message(fields)

Parameters:

fields (dict)

Return type:

bytes

class stogger.systemd.JournalLogger(syslog_identifier='stogger', syslog_facility=0, socket_path=JOURNAL_SOCKET_PATH)

Write log messages to the systemd journal via AF_UNIX socket.

Parameters:

• syslog_identifier (str)

• syslog_facility (int)

• socket_path (str)

syslog_identifier = 'stogger'

syslog_facility = 0

socket_path = '/run/systemd/journal/socket'

msg(messages)

Parameters:

messages (dict)

Return type:

None

class stogger.systemd.DummyJournalLogger

No-op journal logger for non-systemd environments.

msg(messages)

Parameters:

messages (dict)

Return type:

None

class stogger.systemd.JournalLoggerFactory(socket_path=JOURNAL_SOCKET_PATH)

Creates JournalLogger or DummyJournalLogger based on systemd availability.

Parameters:

socket_path (str)

socket_path = '/run/systemd/journal/socket'

stogger.systemd.get_journal_logger_factory()

Return a JournalLoggerFactory instance.

Return type:

JournalLoggerFactory