Registry /
observability / openinference-instrumentation-google-genai
Install & Compatibility
Where this runs
tested against v1.1.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.940 runs
installs and imports cleanly · install 0.0s · import 0.671s · 96.4MB
glibcpy 3.10–3.940 runs
installs and imports cleanly · install 8.6s · import 0.599s · 93MB
90MB installed
● package 90MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
GoogleGenAIInstrumentor
✓ from openinference.instrumentation.google_genai import GoogleGenAIInstrumentor
This quickstart demonstrates how to install and configure `openinference-instrumentation-google-genai` to trace a simple multi-turn chat interaction using the Google GenAI SDK. It integrates with `arize-otel` for setting up the OpenTelemetry tracer provider, which then sends traces to a collector like Arize Phoenix. Remember to set your `GEMINI_API_KEY` and Arize credentials as environment variables.
import os
from openinference.instrumentation.google_genai import GoogleGenAIInstrumentor
from arize.otel import register
from google import genai
# Configure your Google GenAI API key
# It's recommended to set this as an environment variable
# os.environ["GEMINI_API_KEY"] = "your_gemini_api_key"
# Setup OpenTelemetry via Arize's convenience function
# Replace with your actual space_id, api_key, and project_name if using Arize
tracer_provider = register(
space_id=os.environ.get('ARIZE_SPACE_ID', 'YOUR_ARIZE_SPACE_ID'),
api_key=os.environ.get('ARIZE_API_KEY', 'YOUR_ARIZE_API_KEY'),
project_name="my-genai-app",
)
# Instrument the Google GenAI client
GoogleGenAIInstrumentor().instrument(tracer_provider=tracer_provider)
# Ensure GEMINI_API_KEY is set for google-genai to function
if not os.environ.get("GEMINI_API_KEY"):
print("Warning: GEMINI_API_KEY environment variable not set. Using a placeholder.")
# This placeholder will likely cause authentication errors for actual API calls
os.environ["GEMINI_API_KEY"] = "sk-your-gemini-api-key"
def send_message_multi_turn() -> tuple[str, str]:
client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
chat = client.chats.create(model="gemini-1.5-flash-001")
response1 = chat.send_message("What is the capital of France?")
response2 = chat.send_message("Why is the sky blue?")
return response1.text or "", response2.text or ""
if __name__ == "__main__":
print("Starting GenAI chat...")
resp1_text, resp2_text = send_message_multi_turn()
print(f"Response 1: {resp1_text}")
print(f"Response 2: {resp2_text}")
print("Traces should now be available in your configured OpenTelemetry collector (e.g., Arize Phoenix).")
Debug
Known issues
gotchaThe Google GenAI SDK, which this library instruments, can encounter `google.api_core.exceptions.InternalServerError` when chat history grows too large, as the API may not gracefully handle internal quota limits. This is a limitation of the underlying Google GenAI API itself, not the instrumentation, but will manifest in your traced applications.fixManually manage chat history length to stay within API limitations. Consider summarizing or truncating older messages before sending new ones, or starting new chat sessions for long conversations.
affects: All versions
gotchaAs of version 0.1.15, the instrumentation may have limitations in fully tracing advanced features like complex tool calling scenarios (e.g., `tool_use_prompt_token_count` not included in `llm.token_count.prompt`) or the newer Google GenAI Interactions API. Support for these features is actively under development.fixCheck the official OpenInference GitHub repository for updates and newer versions that might include improved support. For critical agentic workflows, manual instrumentation might be necessary to capture full detail.
affects: Prior to future releases addressing these features
gotchaThe OpenInference project and its instrumentations, including for Google GenAI, are rapidly evolving. While stable for core use cases, updates to the underlying Google GenAI SDK or OpenInference semantic conventions could introduce breaking changes or require adjustments to your tracing configuration.fixRegularly review the official OpenInference documentation and GitHub changelog for breaking changes or important updates, especially before upgrading to new major or minor versions.
affects: All versions, due to active development
Upgrade
Version history
1.1.0latest on PyPI · released Jun 11, 2026
Audit
Dependencies
google-genairequiredThis instrumentation library provides tracing for the Google GenAI SDK.
arize-oteloptionalProvides OpenTelemetry setup utilities for sending traces to Arize/Phoenix, commonly used with OpenInference instrumentations.
arize-phoenixoptionalA local AI observability and evaluation platform that can receive and display OpenTelemetry traces.