adk-telemetry 0.8.4

OpenTelemetry integration for Rust Agent Development Kit (ADK-Rust) agent observability
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

//! # ADK Telemetry
//!
//! Production-grade observability for ADK using structured logging and distributed tracing.
//!
//! ## Features
//! - Structured logging with `tracing`
//! - OpenTelemetry integration for distributed tracing
//! - OTLP export for observability backends (Jaeger, Datadog, etc.)
//! - Automatic context propagation
//! - OTel GenAI Semantic Conventions (v1.41.0) via `genai-semconv` feature (enabled by default)
//!
//! ## Usage
//!
//! ```rust
//! use adk_telemetry::{init_telemetry, info, instrument};
//!
//! fn main() -> Result<(), adk_telemetry::TelemetryError> {
//!     // Initialize telemetry in your main
//!     init_telemetry("my-service")?;
//!
//!     // Use logging macros
//!     #[instrument]
//!     async fn my_function() {
//!         info!("Function called");
//!     }
//!     Ok(())
//! }
//! ```

pub mod init;
pub mod span_exporter;
pub mod spans;

// GenAI Semantic Conventions module (feature-gated)
#[cfg(feature = "genai-semconv")]
pub mod semconv;

// Content event configuration (feature-gated)
#[cfg(feature = "genai-semconv")]
pub mod config;

// Content event emitter (feature-gated)
#[cfg(feature = "genai-semconv")]
pub mod events;

// Re-export tracing macros for convenience
pub use tracing::{Span, debug, error, info, instrument, trace, warn};

// Re-export span helpers
pub use spans::*;

// Re-export span exporter (ADK-Go style)
pub use span_exporter::*;

// Re-export init functions and error type
pub use init::{TelemetryError, init_telemetry, init_with_adk_exporter, shutdown_telemetry};
#[cfg(feature = "otlp")]
pub use init::{build_otlp_layer, init_with_otlp};

// Re-export metrics
#[cfg(feature = "otlp")]
pub use opentelemetry::global;
#[cfg(feature = "otlp")]
pub use opentelemetry::metrics::{Meter, MeterProvider};

// Re-export key semconv types for convenience
#[cfg(feature = "genai-semconv")]
pub use semconv::{GenAiOperation, GenAiProvider, GenAiResponseRecorder, GenAiSpanBuilder};