NominalLogStream#

pub struct NominalLogStream#

A bounded log stream. Enqueue acknowledges memory acceptance, not remote durability.

Call flush or close to observe delivery failures. Ambiguous network failures may result in duplicates after retry or journal recovery. No ordering across batches is promised.

Implementations#

impl NominalLogStream
pub fn builder() -> NominalLogStreamBuilder#
pub fn enqueue(&self, channel: &str, record: LogRecord) -> Result<(), LogStreamError>#
pub fn enqueue_batch(&self, channel: &str, records: Vec<LogRecord>) -> Result<(), LogStreamError>#

Accept a complete batch, or reject it before accepting any records. The input batch must fit the memory budget; it is split into request-sized batches internally.

pub fn log_writer(&self, channel: impl Into<String>, args: HashMap<String, String>) -> NominalLogWriter<'_>#

Cache a channel name and common arguments for convenient repeated writes.

pub fn stats(&self) -> LogStreamStats#
pub fn flush(&self) -> Result<LogStreamStats, LogStreamError>#

Block new enqueue calls while all accepted records finish delivery or backup.

pub fn stop_accepting_writes(&self)#
pub fn close(&self) -> Result<LogStreamStats, LogStreamError>#

Stop admission, drain accepted records, and join every worker. Repeated calls are safe and return the same error if a batch was dropped after the last successful flush.

Trait implementations#

impl Drop for NominalLogStream
fn drop(&mut self)

Auto traits: Send, Sync, Unpin, !UnwindSafe, !RefUnwindSafe