Google ADK

Overview

respan-instrumentation-google-adk is an instrumentation plugin that captures traces from the Google Agent Development Kit and sends them to Respan through the unified OTEL pipeline.

The package wraps the upstream OpenInference Google ADK instrumentor and registers a Google-ADK-specific span processor. That processor composes Respan’s generic OpenInference translation and applies ADK-only normalization in this package, so ADK runner, agent, LLM, and tool spans are emitted as Respan log types with gen_ai.*, llm.*, and traceloop.entity.* attributes.

$
pip install respan-instrumentation-google-adk "google-adk[extensions]"

Version: 0.1.0 | Python: >=3.11, <3.14

Dependencies

Quick start

1
from respan import Respan
2
from respan_instrumentation_google_adk import GoogleADKInstrumentor
3
4
respan = Respan(
5
    api_key="your-api-key",
6
    instrumentations=[GoogleADKInstrumentor()],
7
)
8
9
# Now all Google ADK runner, agent, LLM, and tool spans are captured.

Public API

GoogleADKInstrumentor

The main instrumentor class. Implements the Instrumentation protocol.

1
from respan_instrumentation_google_adk import GoogleADKInstrumentor

activate()

When called, activate():

1. Imports openinference.instrumentation.google_adk.GoogleADKInstrumentor.
2. Inserts GoogleADKSpanProcessor before Respan export processors.
3. Calls the upstream instrumentor’s instrument() method so ADK emits spans through OpenTelemetry.

If tracing is disabled through Respan(is_enabled=False), activation is skipped.

deactivate()

Calls the upstream OpenInference instrumentor’s uninstrument() method and removes the Google ADK span processor.

Captured span types

Span attributes

All translated spans include these common attributes:

LLM spans additionally include:

With propagated attributes

Use propagate_attributes() to attach per-request metadata to all spans:

1
from respan import Respan, propagate_attributes
2
from respan_instrumentation_google_adk import GoogleADKInstrumentor
3
4
respan = Respan(
5
    api_key="your-api-key",
6
    instrumentations=[GoogleADKInstrumentor()],
7
)
8
9
async def handle_user_request(user_id: str, message: str):
10
    with propagate_attributes(
11
        customer_identifier=user_id,
12
        thread_identifier="conv_123",
13
        metadata={"source": "web"},
14
    ):
15
        return await run_adk_agent(message)

Architecture

Google ADK
  |
  v
openinference-instrumentation-google-adk
  |
  v
respan-instrumentation-google-adk span processor
  |
  v
generic OpenInference translation + ADK cleanup
  |
  v
OTEL Processor Chain
  |
  v
RespanSpanExporter
  |
  v
POST /v2/traces

Internal modules

These are implementation details, not part of the public API: