Trace Google ADK with BotGauge

Records Google ADK agent runs. The verified zero-code run reaches the model through ADK’s LiteLLM wrapper, and the extra needs google-adk 2.10 or newer.


Extra	`[google-adk]`
Verified framework versions	google-adk 2.10.0 and 2.12.0
Instrumentor installed by the extra	`openinference-instrumentation-google-adk 1.0.4`
Zero-code run	Traced

Also verified: google-adk 2.10.0 with instrumentor 1.0.0. The extra no longer installs that older instrumentor. See supported frameworks for how verification works.

In code

Call tracing.init(), attach the framework instrumentor to the provider it returns, and wrap the work in tracing.turn() and tracing.agent().

This sample calls the model through ADK’s LiteLLM wrapper, so any OpenAI-compatible endpoint works. custom_llm_provider="openai" keeps the plain model name on the LLM span.

Install

terminal

pip install "botgauge[google-adk]" google-adk==2.12.0 litellm==1.103.2

Add the code

app.py

import asyncio
import os

from botgauge import tracing
from google.adk import Agent
from google.adk.models.lite_llm import LiteLlm
from google.adk.runners import InMemoryRunner
from google.genai import types
from openinference.instrumentation.google_adk import GoogleADKInstrumentor

provider = tracing.init()
GoogleADKInstrumentor().instrument(tracer_provider=provider)

model = LiteLlm(
    model=os.environ["OPENAI_MODEL"],
    custom_llm_provider="openai",
    api_base=os.environ["OPENAI_BASE_URL"],
    api_key=os.environ["OPENAI_API_KEY"],
)

async def main():
    agent = Agent(name="researcher", model=model)
    runner = InMemoryRunner(agent=agent, app_name="demo")
    await runner.session_service.create_session(app_name="demo", user_id="user", session_id="s1")
    question = types.Part(text="In one sentence, what is OpenTelemetry?")
    message = types.Content(role="user", parts=[question])
    with tracing.turn(session_id="ses_google_adk"), tracing.agent("google-adk-agent"):
        run = runner.run_async(user_id="user", session_id="s1", new_message=message)
        events = [event async for event in run]
    print(events[-1].content.parts[0].text)

asyncio.run(main())

tracing.shutdown()

Run

terminal

python app.py

Needs BOTGAUGE_API_KEY, OPENAI_MODEL, OPENAI_BASE_URL, OPENAI_API_KEY.

Zero-code

Leave your app unchanged and start it with botgauge instrument. The sample still wraps the work in tracing.turn() and tracing.agent() so spans carry session and agent ids.

This sample calls the model through ADK’s LiteLLM wrapper, so any OpenAI-compatible endpoint works. custom_llm_provider="openai" keeps the plain model name on the LLM span.

Install

terminal

pip install "botgauge[google-adk]" google-adk==2.12.0 litellm==1.103.2

Add the code

app.py

import asyncio
import os

from botgauge import tracing
from google.adk import Agent
from google.adk.models.lite_llm import LiteLlm
from google.adk.runners import InMemoryRunner
from google.genai import types

model = LiteLlm(
    model=os.environ["OPENAI_MODEL"],
    custom_llm_provider="openai",
    api_base=os.environ["OPENAI_BASE_URL"],
    api_key=os.environ["OPENAI_API_KEY"],
)

async def main():
    agent = Agent(name="researcher", model=model)
    runner = InMemoryRunner(agent=agent, app_name="demo")
    await runner.session_service.create_session(app_name="demo", user_id="user", session_id="s1")
    question = types.Part(text="In one sentence, what is OpenTelemetry?")
    message = types.Content(role="user", parts=[question])
    with tracing.turn(session_id="ses_google_adk"), tracing.agent("google-adk-agent"):
        run = runner.run_async(user_id="user", session_id="s1", new_message=message)
        events = [event async for event in run]
    print(events[-1].content.parts[0].text)

asyncio.run(main())

Run

terminal

botgauge instrument python app.py

Needs BOTGAUGE_API_KEY, OPENAI_MODEL, OPENAI_BASE_URL, OPENAI_API_KEY.

View Google ADK spans live

Watch your Google ADK agent runs through LiteLLM appear in BotGauge.

Try BotGauge →

See versions not verified if you run a different version, capture and redaction to control exported content, and troubleshooting if spans are missing. If ADK is older than 2.10, the extra skips ADK and says so at startup. See versions not verified for the two failure modes.

Frameworks

More

Trace Google ADK with BotGauge

In code

Zero-code

​In code

​Zero-code

​Related

In code

Zero-code

Related