Skip to main content

Module telemetry

Module telemetry 

Source
Available on crate feature telemetry only.
Expand description

Telemetry (OpenTelemetry integration).

Production observability:

  • Distributed tracing
  • Metrics collection
  • Log correlation

Available with feature: telemetry

Modules§

configgenai-semconv
Runtime configuration for semantic convention emission.
eventsgenai-semconv
Content event emitter for opt-in prompt/completion capture.
init
Telemetry initialization and configuration
instrument
Attach a span to a std::future::Future.
semconvgenai-semconv
OpenTelemetry GenAI Semantic Convention attribute constants and helpers.
span_exporter
spans
Span helpers for common ADK operations

Macros§

debug
Constructs an event at the debug level.
error
Constructs an event at the error level.
info
Constructs an event at the info level.
trace
Constructs an event at the trace level.
warn
Constructs an event at the warn level.

Structs§

AdkSpanExporter
ADK-Go style span exporter that stores spans by event_id Follows the pattern from APIServerSpanExporter in ADK-Go
AdkSpanLayer
Tracing layer that captures spans and exports them via AdkSpanExporter
GenAiResponseRecorder
Records response-time attributes on the current span.
GenAiSpanBuilder
Builder for creating model call spans with full OTel GenAI semconv attributes.
LlmUsage
Token usage data for recording on tracing spans.
Span
A handle representing a span, with the capability to enter the span if it exists.

Enums§

GenAiOperation
Well-known GenAI operation names per OTel semconv.
GenAiProvider
Well-known GenAI provider identifiers per OTel semconv registry.
TelemetryError
Error returned by telemetry initialization functions.

Functions§

add_context_attributes
Add common attributes to the current span
agent_run_span
Create a span for agent execution
callback_span
Create a span for callback execution
init_telemetry
Initialize basic telemetry with console logging.
init_with_adk_exporter
Initialize telemetry with ADK span exporter.
llm_generate_span
Create a span for LLM generate_content calls with pre-declared token usage fields.
model_call_span
Create a span for model API calls
record_llm_usage
Record LLM token usage on the current span.
shutdown_telemetry
Shutdown telemetry and flush any pending spans.
tool_execute_span
Create a span for tool execution

Attribute Macros§

instrument
Instruments a function to create and enter a tracing span every time the function is called.