Struct StandardObserver 

pub struct StandardObserver { /* private fields */ }

Production-ready observer with reloadable config and per-tier worker pool.

Implementations

impl StandardObserver

pub fn builder() -> StandardObserverBuilder

Builder entry.

pub fn dev() -> Result<StandardObserver, BuildError>

Convenience: StandardObserver with StdoutSink(Full) as fallback.

Errors

Returns BuildError if config validation fails.

pub fn registry(&self) -> Arc<SchemaRegistry>

Read-only access to the registry (used by sinks).

pub fn callsites(&self) -> Arc<ObsCallsiteRegistry>

Read-only access to the per-process callsite registry. Used by the bridge (Direction A inserts; Direction B reads to reconstitute tracing::Metadata). Spec 31 § 3.2.

pub fn config(&self) -> Guard<Arc<EventsConfig>>

Read-only access to the live config.

pub fn set_resource_attrs(&self, attrs: ResourceAttrs)

Atomically swap the resource attribute set. Sinks pick up the new value on the next Observer::resource_attrs call. Spec 20 § 2.1 / spec 94 § 2.7 / P1-E.

pub fn reload_config(&self, new_config: EventsConfig) -> Result<(), BuildError>

Atomically swap the config and bump the generation so all callsites re-probe. Spec 11 § 3.2.

Errors

Returns BuildError::InvalidConfig if validation rejects new_config.

pub fn filter(&self) -> Arc<Filter>

Read-only access to the live filter.

pub fn counters(&self) -> Arc<WorkerCounters>

Worker counters surface for tests + diagnostics.

Trait Implementations

impl Debug for StandardObserver

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

Formats the value using the given formatter.

impl Observer for StandardObserver

fn emit_envelope(&self, env: ObsEnvelope)

Hot-path emit. Never blocks. Never panics. Spec 11 § 3.

fn enabled(&self, callsite: &ObsCallsite) -> bool

Cheap callsite filter check; called only when the cached Interest is Sometimes. Default impl returns true (allows every callsite that survived enabled_static).

fn generation(&self) -> u32

Monotonic generation counter; bumped on every filter / config change so callsite caches re-validate. Spec 11 § 3.2.

fn reload_filter(&self)

Force every callsite’s interest cache back to Unknown. Default impl is a no-op for observers that don’t filter.

fn flush(&self) -> Pin<Box<dyn Future<Output = ()> + Send + '_>>

Flush all sinks; await in-flight batches. Default no-op.

fn shutdown(&self) -> Pin<Box<dyn Future<Output = ()> + Send + '_>>

Shutdown all sinks and join workers. Idempotent.

fn shutdown_blocking(&self, timeout: Duration)

Synchronous shutdown for use in panic hooks and Drop impls where awaiting is not possible. Best-effort within timeout. Spec 11 § 3, § 6.1.

fn callsites(&self) -> Option<Arc<ObsCallsiteRegistry>>

Access this observer’s per-process callsite registry, when it has one. The bridge (Direction A) writes the registry on first sight; ObsToTracingSink reads it to reconstitute tracing::Metadata for interned envelopes. Spec 31 § 3.2.

fn schema_registry(&self) -> Option<Arc<SchemaRegistry>>

Access this observer’s schema registry, when it has one. Sinks hold their own Arc<SchemaRegistry> from construction; this hook lets the bridge fall back to the global observer’s registry without depending on StandardObserver.

fn resource_attrs(&self) -> Arc<ResourceAttrs>

Snapshot of the workspace-shared ResourceAttrs (OTel semantic-convention keys). Sinks call this at flush time so a single config-watcher reload re-projects every sink. Default returns the empty / observer-less attribute set; concrete observers (StandardObserver) override. Spec 20 § 2.1 / spec 94 § 2.7 / P1-E.