---
id: openinference-instrumentation-google-adk
version: "0.1.20"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# openinference-instrumentation-google-adk — OpenInference Google ADK Instrumentation

License: permissive · Maintenance: active · Downloads: 551.9K/mo

## What it is and what it does

This package wraps Google ADK agent execution to automatically capture traces compatible with OpenTelemetry. It instruments agent initialization, tool calls, LLM requests to Gemini, and response generation, emitting structured span data that can be sent to observability backends like Arize Phoenix or Arize AX for visualization and debugging.

The instrumentation is applied via a single `GoogleADKInstrumentor().instrument()` call that attaches to your tracer provider. Once active, it requires no changes to your agent code—traces flow automatically to any OpenTelemetry exporter you configure. It depends on opentelemetry-api, opentelemetry-instrumentation, and OpenInference semantic conventions to ensure traces follow standard LLM observability patterns.

Use it for:

- Debug multi-step agent workflows by viewing the full trace of tool calls, LLM prompts, and responses in Phoenix or Arize AX.
- Monitor production Gemini agents to detect latency bottlenecks, tool failures, or unexpected LLM behavior.
- Collect structured telemetry from agent sessions for post-hoc analysis, cost attribution, or quality audits.
- Integrate agent observability into existing OpenTelemetry infrastructure without rewriting agent code.
- Track session metadata and user interactions alongside agent execution for end-to-end observability.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Auto-instruments Google ADK applications to emit OpenTelemetry-compatible traces for observing agent behavior, tool calls, and LLM interactions.

Yes, if you are building or operating Google ADK agents with Gemini and need observability. The package is actively maintained, has no known vulnerabilities, low install friction, and integrates seamlessly with standard OpenTelemetry tooling. Install it alongside a tracing backend (Phoenix or Arize AX) to gain immediate visibility into agent behavior.

## Install

pip install openinference-instrumentation-google-adk
uv add openinference-instrumentation-google-adk
poetry add openinference-instrumentation-google-adk

## Installing openinference-instrumentation-google-adk

Before you install: Low friction: pure Python wheel with seven stable runtime dependencies (opentelemetry-api, opentelemetry-instrumentation, wrapt, and OpenInference libraries). Active maintenance—released 2 days ago with last commit 2026-08-14—and supports Python 3.10 through 3.14.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most production and internal projects.

Quickstart:

pip install openinference-instrumentation-google-adk

from openinference.instrumentation.google_adk import GoogleADKInstrumentor
from opentelemetry.sdk import trace as trace_sdk

tracer_provider = trace_sdk.TracerProvider()
GoogleADKInstrumentor().instrument(tracer_provider=tracer_provider)

Requires GOOGLE_API_KEY environment variable to authenticate with Gemini API; also requires a tracing backend (e.g., Arize Phoenix or OpenTelemetry collector) to receive and view traces.

Verify before relying:

- Whether this package works with Google ADK versions other than those tested in CI/CD
- Performance overhead when instrumenting high-volume agent workloads
- Compatibility with custom Google ADK extensions or third-party agent frameworks

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 551.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

google adk instrumentation, opentelemetry google adk tracing, llm agent observability, gemini agent tracing, openinference instrumentation, adk span collection, agent execution traces, observability, llm-tracing, agent-instrumentation

[View on SkillFed](https://skillfed.io/packages/openinference-instrumentation-google-adk) · [View on PyPI](https://pypi.org/project/openinference-instrumentation-google-adk/)