Module journald 

Native systemd journal submission and field recording.

The module routes formatted messages to the journal socket and records structured tracing fields for journal queries.

Structs

Entry

One entry, submitted when the writer is dropped. Its payload accumulates in the thread’s buffer, which the fields layer opened for this event.

Fields

Records the fields of each event and span for the entry the wrapped console layer is about to write, leaving them queryable with journalctl F_NAME=value.

Journal

Datagram connection to the journald submission socket.

SpanFields 🔒

Encoded fields of one span, held in its registry extensions.

Visitor 🔒

Constants

IDENTIFIER 🔒

LEN_PREFIX 🔒

NAME_MAX 🔒

Journald rejects a longer field name.

PAYLOAD 🔒

Entry under construction on this thread, reused across events.

PAYLOAD_MAX 🔒

Bounds the datagram well under the default socket send buffer.

PREFIX 🔒

Keeps a user field from colliding with one of the journal’s own.

SOCKET 🔒

Functions

boundary 🔒

Steps back to the nearest character boundary at or below len; a continuation byte never begins a character.

close 🔒

Seals the message field, trimming the formatter’s trailing whitespace and truncating on a character boundary what the datagram cannot carry.

enabled 🔒

Whether events are submitted to journald rather than written to the console, which journald otherwise captures at a single fixed priority.

extend_scope 🔒

Appends the fields of every span enclosing the event, innermost first.

fallback 🔒

Writes a message the socket would not take to the console, which journald captures in turn under systemd.

identifier 🔒

Tags entries with the running executable’s name.

priority 🔒

Maps a level onto the syslog severity code journald expects.

put 🔒

Appends a length-encoded field, which may carry any byte sequence.

record_event 🔒

Opens this thread’s buffer with the event’s fields and those of the spans enclosing it, for the entry the console writer appends to next.

record_span 🔒

Encodes a span’s fields once, for every event it later encloses.

record_values 🔒

Appends the fields of a span recorded after its creation.

sanitize 🔒

Journald accepts only uppercase alphanumerics and underscores in a field name, and drops a field whose name it rejects.

Type Aliases

Buffer 🔒

Encoded journal fields; a longer run spills to the heap.

CodeLine 🔒

Formatted source line number.

FieldName 🔒

Journal name of a user field, including the prefix.

FieldValue 🔒

Value of a user field recorded through its Debug implementation.

Identifier 🔒

Syslog identifier tagging every entry.