Enum ObservabilityMode 

pub enum ObservabilityMode {
    Production,
    Analysis,
    Debug,
}

Controls the verbosity of agent execution observability.

Configurable via:

1. HEARTBIT_OBSERVABILITY env var (highest priority)
2. [telemetry] observability_mode in config TOML
3. AgentRunnerBuilder::observability_mode() / OrchestratorBuilder::observability_mode()
4. Default: Production

Variants

Production

Near-zero overhead: span names + durations only.

Analysis

Metrics: tokens, latencies, costs, stop reasons.

Debug

Full payloads (truncated to 4KB) for debugging.

Implementations

impl ObservabilityMode

pub fn from_str_loose(s: &str) -> Option<Self>

Parse from a case-insensitive string. Returns None for unknown values.

pub fn resolve( env_key: &str, config_str: Option<&str>, builder_value: Option<ObservabilityMode>, ) -> Self

Resolve the effective mode from all configuration sources.

Priority: env var > config string > builder value > default.

pub fn includes_metrics(self) -> bool

Whether this mode includes metrics (token counts, latencies, costs).

pub fn includes_payloads(self) -> bool

Whether this mode includes full payloads (request/response text, tool I/O).

Trait Implementations

impl Clone for ObservabilityMode

fn clone(&self) -> ObservabilityMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ObservabilityMode

impl Debug for ObservabilityMode

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

Formats the value using the given formatter.

impl Default for ObservabilityMode

fn default() -> ObservabilityMode

Returns the “default value” for a type.

impl Display for ObservabilityMode

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

Formats the value using the given formatter.

impl Eq for ObservabilityMode

impl PartialEq for ObservabilityMode

fn eq(&self, other: &ObservabilityMode) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ObservabilityMode