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.3

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.3
File Size Uploaded Provenance Actions
openinference_instrumentation_agno-1.2.3.tar.gz 28.5 kB With provenance Details for openinference_instrumentation_agno-1.2.3.tar.gz

Built distribution (wheel)

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

Total release size: 62.7 kB

Release files / openinference_instrumentation_agno-1.2.3.tar.gz

Download URL openinference_instrumentation_agno-1.2.3.tar.gz
Size 28.5 kB
Tags Source
SHA-256 checksum
How to use checksums
cf52ea250abe24bbcf8553a64b064affb439a5a4768e09a8081359a7e816b1cf
BLAKE2b-256 checksum
How to use checksums
69d8991208e10a19ca505fcc413582aac9d4b8a674564d9aa8f80be30ce6b27b
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.3-py3-none-any.whl

Download URL openinference_instrumentation_agno-1.2.3-py3-none-any.whl
Size 34.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ce00f7176aa23b3d9a43a9afde4c1aa443694bea811caf4613c8a3b978dd1064
BLAKE2b-256 checksum
How to use checksums
2931626e4b602aca9fd4d4875b0912d6d58a82da97a18bfa5d30aa770567e958
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.3

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.3.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.3 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