Skip to main content

OpenInference Agno Instrumentation

pypi

Python auto-instrumentation library for Agno Agents

The following instrumentation is fully OpenTelemetry-compatible and can be sent to an OpenTelemetry collector for monitoring, such as Arize Phoenix, Arize AX, or Langfuse.

Installation

pip install openinference-instrumentation-agno

Quickstart

This quickstart shows you how to instrument your Agno Agent application.

You've already installed openinference-instrumentation-agno. Next is to install packages for agno, Phoenix and opentelemetry-instrument, which exports traces to it.

pip install agno arize-phoenix opentelemetry-sdk opentelemetry-exporter-otlp-proto-grpc opentelemetry-distro

Start the Phoenix app in the background as a collector:

phoenix serve

By default, it listens on http://localhost:6006. You can visit the app via a browser at the same address.

The Phoenix app does not send data over the internet. It only operates locally on your machine.

Create a simple Agno agent:

from agno.agent import Agent
from agno.models.openai import OpenAIChat
from agno.tools.duckduckgo import DuckDuckGoTools

from openinference.instrumentation.agno import AgnoInstrumentor
from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
from opentelemetry.sdk import trace as trace_sdk
from opentelemetry import trace as trace_api
from opentelemetry.sdk.trace.export import ConsoleSpanExporter, SimpleSpanProcessor

endpoint = "http://127.0.0.1:6006/v1/traces"
tracer_provider = trace_sdk.TracerProvider()
tracer_provider.add_span_processor(SimpleSpanProcessor(OTLPSpanExporter(endpoint)))
# Optionally, you can also print the spans to the console.
tracer_provider.add_span_processor(SimpleSpanProcessor(ConsoleSpanExporter()))

trace_api.set_tracer_provider(tracer_provider=tracer_provider)

# Start instrumenting agno
AgnoInstrumentor().instrument()


agent = Agent(
    model=OpenAIChat(id="gpt-4o-mini"), 
    tools=[DuckDuckGoTools()],
    markdown=True, 
    debug_mode=True,
)

agent.print_response("What is currently trending on Twitter?")

Finally, run the example:

python example.py

Finally, browse for your trace in Phoenix at http://localhost:6006!

Isolating agno spans from the host context

By default, agno spans become the current span in OpenTelemetry's global context, so they nest under whatever span the host application has active. Pass runtime_context to keep them in a separate context instead:

from opentelemetry.context.contextvars_context import ContextVarsRuntimeContext

AgnoInstrumentor().instrument(
    tracer_provider=tracer_provider,
    runtime_context=ContextVarsRuntimeContext(),
)

Any object with attach, get_current and detach, such as an OpenTelemetry _RuntimeContext, works. Agno spans then form their own trace and never replace the host's current span. Code that agno calls, such as a tool, still sees the host's span as current.

Only agno's own spans use the injected context. Spans from other instrumentors that run inside agno, such as OpenAIInstrumentor, still read the global context, so they parent to the host span rather than to the agno span that made the call.

More Info

Metadata

Release files for openinference-instrumentation-agno 1.2.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-agno 1.2.2
File Size Uploaded Provenance Actions
openinference_instrumentation_agno-1.2.2.tar.gz 28.1 kB With provenance Details for openinference_instrumentation_agno-1.2.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for openinference-instrumentation-agno 1.2.2
File Interpreter ABI Platform Actions
openinference_instrumentation_agno-1.2.2-py3-none-any.whl Python 3 none any Details for openinference_instrumentation_agno-1.2.2-py3-none-any.whl

Total release size: 61.7 kB

Release files / openinference_instrumentation_agno-1.2.2.tar.gz

Download URL openinference_instrumentation_agno-1.2.2.tar.gz
Size 28.1 kB
Tags Source
SHA-256 checksum
How to use checksums
09c40d382fbf22fcff731a6ac60dac08ea78d9c7d170b9a47e40e175f702afd4
BLAKE2b-256 checksum
How to use checksums
d4257586ffc11366d6fe8bbdfe5dbe071051a83cc39b7c386d3e85e971250e3d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / openinference_instrumentation_agno-1.2.2-py3-none-any.whl

Download URL openinference_instrumentation_agno-1.2.2-py3-none-any.whl
Size 33.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cce3c34111485e06c94dee0dd5c405ac593d50fd22cbbebb947f26ac0ac14c1a
BLAKE2b-256 checksum
How to use checksums
95fa44ddad93767991100f9eb6080d62382a746728ecfd4cdd1d5e2de9551ef5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Security for openinference-instrumentation-agno 1.2.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for openinference_instrumentation_agno-1.2.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.2.2 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page