Crate spectra_runtime 

Runtime assembly: builder, async storage persist, and optional off-thread telemetry I/O.

Application crates usually depend on spectra instead of this crate directly.

• Spectra::builder() / SpectraBuilder — inject backends, optional transport sink, and topology flags
• SpectraBuilder::persist — L2 queue/batch settings (PersistConfig; no env knobs)
• Spectra::flush_persist — durable barrier after *_now emits (Write Now scripts)
• SpectraBuilder::sink + SpectraBuilder::persist_disabled — publisher wiring for distributed ingest (consumers own storage; see spectra Getting started → Mode 2)
• StoragePersistSink — default async persist to registered storage backends
• OffThreadSpectraSink — off-thread NDJSON + console mirror (telemetry-console feature)
• Both metrics_backend and events_backend are required before SpectraBuilder::build.
• With persist_disabled, a transport .sink is mandatory.

Structs

OffThreadSpectraSink

Sink that enqueues NDJSON + optional console mirror work for a background thread.

PersistConfig

Queue and batch settings for crate::StoragePersistSink.

PersistHandle

Handle to wait until the persist queue has drained prior emits.

Spectra

Handle to an installed process-wide Spectra runtime.

SpectraBuilder

Configures and installs Spectra with explicit storage adapter injection.

StoragePersistSink

SpectraSink that queues telemetry for asynchronous storage through a SpectraRouter.

Enums

PersistOverflow

Behavior when the L2 persist queue is full.

Functions

console_mirror_enabled

Returns true when stderr console mirror is enabled (default: true).

format_console_line

Build a single [spectra:console] line when schema fields are console-safe.

off_thread_emit_enabled

Returns true when hot-path emit should use the off-thread writer (default: true).