Struct ObservabilityConfig 

pub struct ObservabilityConfig {
    pub enabled: bool,
    pub endpoint: String,
    pub protocol: OtelProtocol,
    pub service_name: String,
    pub service_version: String,
    pub sampling_ratio: f64,
    pub timeout: Duration,
    pub verify_presence_oracle: bool,
}

Runtime observability configuration.

Construct via ObservabilityConfig::from_env for the standard CQLITE_OTEL_* behaviour, or ObservabilityConfig::builder to set fields programmatically (e.g. in tests that want a disabled / no-export config).

Fields

enabled: bool

Master enable switch. When false, init returns an inert guard and installs no exporters or global providers, regardless of the feature.

endpoint: String

OTLP endpoint (gRPC endpoint or HTTP base URL).

protocol: OtelProtocol

Wire protocol.

service_name: String

service.name resource attribute.

service_version: String

service.version resource attribute.

sampling_ratio: f64

Trace-ID-ratio sampling probability in [0.0, 1.0]. Wrapped in a parent-based sampler so children of a sampled span are always recorded.

timeout: Duration

Exporter export timeout.

verify_presence_oracle: bool

Opt-in, default-OFF presence-oracle false-negative verification (issue #2163). When true, an SSTable read whose bloom/BTI-trie reports a key “definitely absent” runs an AUTHORITATIVE confirmation scan and increments cqlite.read.bloom.false_negatives on a contradiction. Populated from CQLITE_VERIFY_PRESENCE_ORACLE; the read path itself consults the process-global switch in crate::storage::sstable::reader::presence_verification, which reads the SAME environment variable, so this field mirrors that runtime state.

Implementations

impl ObservabilityConfig

pub fn builder() -> ObservabilityConfigBuilder

Start from defaults and override fields fluently.

pub fn from_env() -> Self

Populate from the CQLITE_OTEL_* environment variables, falling back to the documented defaults for anything unset or unparseable.

Unparseable values fall back to the default rather than erroring, so a typo in an env var never crashes the host process.

Trait Implementations

impl Clone for ObservabilityConfig

fn clone(&self) -> ObservabilityConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ObservabilityConfig

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

Formats the value using the given formatter.

impl Default for ObservabilityConfig

fn default() -> Self

Returns the “default value” for a type.