Skip to main content

​
Installation

pip install respan-exporter-agno

​
Classes

​
RespanAgnoExporter

Core exporter that converts Agno traces to Respan format. 
from respan_exporter_agno import RespanAgnoExporter
ParameterTypeDefaultDescription
api_keystr | NoneNoneRespan API key. Falls back to RESPAN_API_KEY env var.
base_urlstr | NoneNoneAPI base URL. Falls back to RESPAN_BASE_URL.

​
Methods

MethodDescription
export(trace_or_spans)Export traces to Respan.
export_trace(trace_or_spans)Alias for export().
build_payload(trace_or_spans)Build Respan payload from traces.

​
RespanAgnoInstrumentor

OpenTelemetry instrumentor that patches Agno’s span processors to send data to Respan. 
from respan_exporter_agno import RespanAgnoInstrumentor

​
Class method

MethodDescription
instrument(api_key, endpoint, base_url, environment, customer_identifier)Initialize and enable instrumentation.
ParameterTypeDefaultDescription
api_keystr | NoneNoneRespan API key.
endpointstr | NoneNoneIngest endpoint URL.
base_urlstr | NoneNoneAPI base URL.
environmentstr | NoneNoneEnvironment label.
customer_identifierstr | NoneNoneDefault customer identifier.

​
Usage

from agno.agent import Agent
from agno.models.openai import OpenAIChat
from respan_exporter_agno import RespanAgnoInstrumentor

# Initialize instrumentation
RespanAgnoInstrumentor.instrument(api_key="your-api-key")

# Use Agno normally
agent = Agent(
    model=OpenAIChat(id="gpt-4o-mini"),
    instructions="You are helpful.",
)
agent.print_response("Tell me a joke")

​
Internal features

  • Span deduplication cache (10k max by default)
  • Automatic conversion from Agno trace format to Respan spans