Struct SelfEventBuilder 

pub struct SelfEventBuilder { /* private fields */ }

Fluent builder for runtime-style self-events.

Sinks, middleware, and tok’s own init paths emit labels-only self-events (ObsConfigReloaded, ObsBatchSinkUploaded, …). The plain obs_core::self_event helper returns a bare envelope that the caller mutates; the builder wraps that in a fluent chain for call sites that set two or more labels.

use obs_kit::SelfEventBuilder;
use obs_kit::{Severity, Tier};

SelfEventBuilder::new("mylib.v1.WorkerRestart", Tier::Log, Severity::Warn)
    .label("reason", "timeout")
    .label("worker_id", "42")
    .emit();

Implementations

impl SelfEventBuilder

pub fn new(full_name: &str, tier: Tier, sev: Severity) -> Self

Start a new builder with the given full_name, tier, and sev. sampling_reason is set to SAMPLING_REASON_RUNTIME and ts_ns to the current wall-clock via obs_core::self_event.

pub fn label(self, key: impl Into<String>, value: impl Into<String>) -> Self

Insert (or replace) a label.

pub fn labels<I, K, V>(self, iter: I) -> Self

where I: IntoIterator<Item = (K, V)>, K: Into<String>, V: Into<String>,

Extend the envelope with an iterator of (key, value) pairs. Useful when the labels come from a pre-built BTreeMap/HashMap.

pub fn emit(self)

Emit the envelope through the active observer.

pub fn build(self) -> ObsEnvelope

Return the built envelope without emitting. Useful for tests and for call sites that want to attach a payload before handing the envelope to a sink manually.

Trait Implementations

impl Debug for SelfEventBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.