Struct TelemetrySetup 

pub struct TelemetrySetup {
    pub service_name: String,
    pub otlp_endpoint: Option<String>,
    pub cloud_trace: bool,
    pub capture_content: bool,
}

Configuration for telemetry export.

Use the builder methods to configure the desired exporters, then call init to set up the global tracing subscriber.

Examples

use gemini_adk_rs::telemetry::setup::TelemetrySetup;

// Basic setup with console logging only
TelemetrySetup::new("my-agent-service").init().unwrap();

// With OTLP export (requires `otel-otlp` feature)
TelemetrySetup::new("my-agent-service")
    .with_otlp("http://localhost:4317")
    .with_content_capture(true)
    .init()
    .unwrap();

// With Google Cloud Trace (requires `otel-gcp` feature)
TelemetrySetup::new("my-agent-service")
    .with_cloud_trace()
    .init()
    .unwrap();

Fields

service_name: String

Service name for OTel resource identification.

otlp_endpoint: Option<String>

OTLP gRPC endpoint (e.g., http://localhost:4317). When set, enables OTLP trace export (requires otel-otlp feature).

cloud_trace: bool

Enable Google Cloud Trace export (requires otel-gcp feature).

capture_content: bool

Whether to capture prompt/completion content in spans. Defaults to false to avoid logging sensitive data.

Implementations

impl TelemetrySetup

pub fn new(service_name: impl Into<String>) -> Self

Create a new telemetry setup with the given service name.

Defaults to console logging only, no OTLP or Cloud Trace export, and content capture disabled.

pub fn with_otlp(self, endpoint: impl Into<String>) -> Self

Set the OTLP gRPC endpoint for trace export.

Requires the otel-otlp feature. If the feature is not enabled, this value is ignored during init.

pub fn with_cloud_trace(self) -> Self

Enable Google Cloud Trace export.

Requires the otel-gcp feature. If the feature is not enabled, this value is ignored during init.

pub fn with_content_capture(self, capture: bool) -> Self

Set whether to capture prompt/completion content in trace spans.

Defaults to false. When enabled, LLM request and response content may be recorded in span attributes, which is useful for debugging but should be disabled in production to avoid logging sensitive data.

pub fn init(self) -> Result<(), Box<dyn Error>>

Initialize the tracing subscriber with the configured exporters.

This is a convenience function that sets up:

• tracing-subscriber with EnvFilter (reads RUST_LOG env var, defaults to info)
• OpenTelemetry tracer (if otlp_endpoint is set and otel-otlp feature is enabled)
• Google Cloud Trace (if cloud_trace is set and otel-gcp feature is enabled)
• Pretty log format for development

Feature behavior

Features enabled	Behavior
(none)	Console logging with env-filter
otel-otlp	Console + OTLP trace export
otel-gcp	Console + Cloud Trace export

Errors

Returns an error if the tracing subscriber cannot be set (e.g., if one is already registered globally), or if OTel exporter initialization fails.

Trait Implementations

impl Clone for TelemetrySetup

fn clone(&self) -> TelemetrySetup

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TelemetrySetup

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

Formats the value using the given formatter.