Logging - API reference

Exported surface for the logging subsystem. Part of the API reference.

Package `valis/src/logging`

Classes

`substrate-json-appender`

A log4cl appender that emits the current substrate event as a single jzon object per line, never the free-form log message.

Conditions

`unknown-substrate-event`

Signalled when log-event is handed an event name not in the taxonomy. Fail closed rather than emit an event at an unknown level.

Functions

`log-event`

(log-event event subsystem &rest fields)

Log a substrate lifecycle EVENT for SUBSYSTEM, with optional scalar event-specific FIELDS as a keyword plist (e.g. :days-to-expiry 3). The level is resolved from substrate-event-catalog; an unknown event signals unknown-substrate-event. Emits exactly one jzon object per line to substrate-log-stream. Returns the event object (for inspection/testing).

There is no message parameter: substrate facts only, never content.

Variables

`substrate-event-catalog`

The substrate event vocabulary: each lifecycle event name mapped to the level it is logged at. This is the shared taxonomy downstream lifecycle wiring consumes rather than re-deriving. Later modules extend it by adding entries here.

`substrate-log-stream`

The stream substrate event lines are written to. Defaults to error-output so a systemd-supervised resident's lines land in journald. Tests bind it to a captured string stream to stay hermetic.