Logging - API reference

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

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

(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.

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.

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.

Undocumented: this exported symbol needs a docstring.

backup.kdf-cost-overridden, logged at WARN whenever a backup is sealed at a key-derivation cost other than mercer's production cost, lower or higher. Names the argon2id block count and pass count used, so a backup sealed at anything but the production cost never passes unnoticed.

Undocumented: this exported symbol needs a docstring.

Undocumented: this exported symbol needs a docstring.

Undocumented: this exported symbol needs a docstring.

Undocumented: this exported symbol needs a docstring.

Undocumented: this exported symbol needs a docstring.

Undocumented: this exported symbol needs a docstring.

Undocumented: this exported symbol needs a docstring.

config.environment-superseded, logged at WARN. Names, by key path and never by value, every key whose environment value the configuration store overrides.

config.held-in-environment, logged at INFO on every boot whose environment value for a key carries a secret, which therefore stays out of the store. Names the key.

config.rebind-failed, logged at WARN. Names a key and the type of the condition its rebinding signalled, after the key's new value was stored; the value takes effect at the next restart. Never a value.

config.seed-refused, logged at WARN. Names a key and its type when the environment value offered for it is not of that type and was not stored.

Undocumented: this exported symbol needs a docstring.

Undocumented: this exported symbol needs a docstring.

Undocumented: this exported symbol needs a docstring.

Undocumented: this exported symbol needs a docstring.

Undocumented: this exported symbol needs a docstring.

Undocumented: this exported symbol needs a docstring.

module.settings-declared, logged at INFO when a module that states settings in its define-module form registers them. Names the system its settings are kept under and how many keys it declares.

module.settings-kept-aside, logged at WARN when the node keeps aside, in a module's settings file, values its owner set that the version of the module now loaded could not carry: no key takes them, the module's migration signalled, or a key's own check refused the value. Names the system, each key path set aside, and the condition type when the migration or a check signalled. Never a value.

Undocumented: this exported symbol needs a docstring.

Undocumented: this exported symbol needs a docstring.

Undocumented: this exported symbol needs a docstring.

Undocumented: this exported symbol needs a docstring.

Undocumented: this exported symbol needs a docstring.