Struct ObservabilityConfig 

pub struct ObservabilityConfig {
    pub enable_sensitive_data: bool,
    pub otel_semconv_stability_opt_in: Option<String>,
}

Observability configuration read from the process environment, mirroring (a subset of) Python’s ObservabilitySettings (observability.py:347-394).

This port intentionally does not read ENABLE_OTEL: Python uses that flag to skip constructing spans entirely when no heavier OTel SDK is configured. This crate’s spans are plain tracing spans, which are already effectively free when no subscriber is attached, so there is no separate “enable” switch — attach a subscriber (optionally bridged to OTel; see the module docs) to turn observability on.

This crate does not build an OTel Resource, exporter, or MeterProvider — see the module docs for wiring those yourself.

Fields

enable_sensitive_data: bool

Whether message / system-instructions / tool-definition / tool-call content capture is enabled. Reads ENABLE_SENSITIVE_DATA (mirrors Python’s enable_sensitive_data — “Warning: Sensitive events should only be enabled on test and development environments.”).

otel_semconv_stability_opt_in: Option<String>

The raw OTEL_SEMCONV_STABILITY_OPT_IN value: a comma-separated opt-in list in OpenTelemetry’s standard format. Only the GEN_AI_LATEST_EXPERIMENTAL_OPT_IN token is consulted here — see use_latest_experimental_gen_ai_semconv.

Implementations

impl ObservabilityConfig

pub fn from_env() -> ObservabilityConfig

Read configuration from the process environment. Unset or unrecognized values default to false (matching Python’s default). Recognized truthy values (case-insensitive, surrounding whitespace ignored): "1", "true", "yes", "on".

pub fn use_latest_experimental_gen_ai_semconv(&self) -> bool

Whether to emit the GenAI semantic conventions above the v1.36.0 baseline.

v1.36.0 is the OTel-recommended baseline; every version above it is “latest” here. Computed from otel_semconv_stability_opt_in: unset defaults to true (opted in), which — as upstream documents — deliberately differs from OpenTelemetry’s own default of retaining the baseline. Set the variable to a list that omits GEN_AI_LATEST_EXPERIMENTAL_OPT_IN to get the baseline instead.

Two things change when this is false:

• the provider is reported as gen_ai.system rather than gen_ai.provider.name (the rename landed above v1.36.0), and
• the attributes introduced above the baseline (gen_ai.usage.cache_creation.input_tokens, gen_ai.usage.cache_read.input_tokens, gen_ai.usage.reasoning.output_tokens, gen_ai.tool.definitions, gen_ai.tool.call.arguments, gen_ai.tool.call.result) are not emitted at all.

pub fn emit_tool_call_attributes(&self) -> bool

Whether to emit gen_ai.tool.call.arguments / gen_ai.tool.call.result on execute_tool spans. These carry tool content and were introduced above v1.36.0, so they need both content capture and the semconv version that defines them.

pub fn otel_service_name(&self) -> String

The OTEL_SERVICE_NAME passthrough, defaulting to "agent_framework" (mirrors Python’s _create_resource, observability.py:336-344). This crate does not build a Resource from it — it’s exposed so an app wiring its own OTel Resource (see the module docs) can stay consistent with whatever this reads. Reads the environment fresh on every call rather than caching it at from_env time.

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<(), Error>

Formats the value using the given formatter.

impl Default for ObservabilityConfig

fn default() -> ObservabilityConfig

Returns the “default value” for a type.