OpenInference Google GenAI Instrumentation

Python auto-instrumentation library for GenAI SDK. Traces are fully OpenTelemetry compatible and can be sent to any OpenTelemetry collector for viewing, such as Arize Phoenix.

Installation

pip install -Uqqq openinference-instrumentation-google-genai

Quickstart

Install openinference-instrumentation-google-genai and arize-phoenix.

pip install -U \
    openinference-instrumentation-google-genai \
    arize-phoenix \
    opentelemetry-sdk \
    opentelemetry-exporter-otlp \
    "opentelemetry-proto>=1.12.0"

Start the phoenix server so that it is ready to receive traces. The phoenix server runs entirely on your machine and does not send data over the internet.

phoenix serve

Instrumenting genai is simple.

from openinference.instrumentation.google_genai import GoogleGenAIInstrumentor
from opentelemetry.exporter.otlp.proto.grpc.trace_exporter import OTLPSpanExporter
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import SimpleSpanProcessor

endpoint = "http://127.0.0.1:4317"
tracer_provider = TracerProvider()
tracer_provider.add_span_processor(SimpleSpanProcessor(OTLPSpanExporter(endpoint)))

GoogleGenAIInstrumentor().instrument(tracer_provider=tracer_provider)

Now, all calls by generate_content are instrumented and can be viewed in the phoenix UI.

Progress

This instrumentation is a work in progress

parse messages and invocation
capture tool definitions

More Info

Metadata

Release files for openinference-instrumentation-google-genai 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for openinference-instrumentation-google-genai 0.1.2
File	Size	Uploaded
openinference_instrumentation_google_genai-0.1.2.tar.gz	21.3 kB	May 30, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for openinference-instrumentation-google-genai 0.1.2
File	Interpreter	ABI	Platform	Reset
openinference_instrumentation_google_genai-0.1.2-py3-none-any.whl 19.3 kB May 30, 2025	Python 3	none	any	Details

Total release size: 40.5 kB

Release files / openinference_instrumentation_google_genai-0.1.2.tar.gz

Download URL	openinference_instrumentation_google_genai-0.1.2.tar.gz
Size	21.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`8eec5bc7e3619ab501d33a62e7302fd990f5485c2141e6f5169ae73cfc901eba`
BLAKE2b-256 checksum How to use checksums	`7d87c730b40c0a67a6f2a01f60d2daf8fa4e1574a2a26f22d6167181add671ab`
Upload date	May 30, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.3`

Release files / openinference_instrumentation_google_genai-0.1.2-py3-none-any.whl

Download URL	openinference_instrumentation_google_genai-0.1.2-py3-none-any.whl
Size	19.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`8725489c955cdebc89ea5815c3dfcea38f351e28792987b506706eecfaa37167`
BLAKE2b-256 checksum How to use checksums	`9d5fd261bd7f61f8282eb00bc2a1ab18bea23c049f831468a0d24a933cabc9b3`
Upload date	May 30, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.3`