openinference-instrumentation-google-adk

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 on this page — 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

openinference-instrumentation-google-adk on PyPI

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

Evidence: openinference_instrumentation_google_adk-0.1.20-py3-none-any.whl

Tags

More Monitoring packages