Python SDKExporters (Legacy)

Agno Exporter

Installation

$pip install respan-exporter-agno

Classes

RespanAgnoExporter

Core exporter that converts Agno traces to Respan format.

1from 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.

1from 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

1from agno.agent import Agent
2from agno.models.openai import OpenAIChat
3from respan_exporter_agno import RespanAgnoInstrumentor
4
5# Initialize instrumentation
6RespanAgnoInstrumentor.instrument(api_key="your-api-key")
7
8# Use Agno normally
9agent = Agent(
10    model=OpenAIChat(id="gpt-4o-mini"),
11    instructions="You are helpful.",
12)
13agent.print_response("Tell me a joke")

Internal features

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