From ae1dbcde6d9ed909e115690d564738f50e0dc827 Mon Sep 17 00:00:00 2001 From: Darsh Poddar Date: Sun, 22 Mar 2026 22:10:20 -0700 Subject: [PATCH 1/2] docs: add Respan observability integration Co-Authored-By: Claude Opus 4.6 (1M context) --- docs.json | 1 + observability/overview.mdx | 2 +- observability/respan.mdx | 67 ++++++++++++++++++++++++++++++++++++++ 3 files changed, 69 insertions(+), 1 deletion(-) create mode 100644 observability/respan.mdx diff --git a/docs.json b/docs.json index 38c0eae58..150e05ce8 100644 --- a/docs.json +++ b/docs.json @@ -4102,6 +4102,7 @@ "observability/maxim", "observability/mlflow", "observability/openlit", + "observability/respan", "observability/traceloop", "observability/weave" ] diff --git a/observability/overview.mdx b/observability/overview.mdx index 432330673..80b66976a 100644 --- a/observability/overview.mdx +++ b/observability/overview.mdx @@ -19,6 +19,6 @@ Agno offers first-class support for OpenTelemetry, the industry standard for dis - **Custom Tracing**: Extend or customize tracing as needed. -OpenTelemetry-compatible backends including Arize Phoenix, Langfuse, Langsmith, Langtrace, Logfire, Maxim, MLflow, OpenLIT, Traceloop, and Weave are supported by Agno out of the box. +OpenTelemetry-compatible backends including Arize Phoenix, Langfuse, Langsmith, Langtrace, Logfire, Maxim, MLflow, OpenLIT, Respan, Traceloop, and Weave are supported by Agno out of the box. diff --git a/observability/respan.mdx b/observability/respan.mdx new file mode 100644 index 000000000..d2a91220e --- /dev/null +++ b/observability/respan.mdx @@ -0,0 +1,67 @@ +--- +title: Respan +description: Integrate Agno with Respan to trace agent workflows and monitor performance. +--- + +## Integrating Agno with Respan + +[Respan](https://respan.ai) is an observability platform for tracing and monitoring AI agents. The `respan-exporter-agno` package captures Agno's OpenInference trace data and sends it to Respan. + +## Prerequisites + +1. **Install Dependencies** + + ```bash + uv pip install agno openinference-instrumentation-agno respan-exporter-agno + ``` + +2. **Setup Respan Account** + + - Create an account at [platform.respan.ai](https://platform.respan.ai). + - Generate an API key on the [API keys page](https://platform.respan.ai/platform/api/api-keys). + +3. **Set Environment Variables** + + ```bash + export RESPAN_API_KEY= + ``` + +## Sending Traces to Respan + +```python +from agno.agent import Agent +from agno.models.openai import OpenAIChat +from respan_exporter_agno import RespanAgnoInstrumentor + +# Initialize Respan instrumentation +RespanAgnoInstrumentor.instrument() + +# Create and configure the agent +agent = Agent( + model=OpenAIChat(id="gpt-4o-mini"), + instructions="You are a helpful assistant.", +) + +# Use the agent +agent.print_response("Tell me a joke about AI") +``` + +View your traces on the [Traces page](https://platform.respan.ai/platform/traces) in the Respan dashboard. + +## Configuration + +`RespanAgnoInstrumentor.instrument()` accepts the following parameters: + +| Parameter | Type | Default | Description | +| --------------------- | ------------- | ------------------------ | ---------------------------- | +| `api_key` | `str` | `RESPAN_API_KEY` env var | Respan API key. | +| `endpoint` | `str \| None` | `None` | Custom ingest endpoint URL. | +| `base_url` | `str \| None` | `None` | API base URL. | +| `environment` | `str \| None` | `None` | Environment label. | +| `customer_identifier` | `str \| None` | `None` | Default customer identifier. | + +## Notes + +- **Environment Variables**: Set `RESPAN_API_KEY` to avoid passing `api_key` directly in code. +- **Initialization Order**: Call `RespanAgnoInstrumentor.instrument()` before creating any agents. +- **Respan Docs**: See the [Respan Agno integration guide](https://respan.ai/docs/integrations/tracing/agno) for additional details. From 3268d944fdabdc3698746d2015e29fc94134aaed Mon Sep 17 00:00:00 2001 From: Darsh Poddar Date: Sun, 22 Mar 2026 22:23:40 -0700 Subject: [PATCH 2/2] docs: remove unnecessary backslash escapes in type column Co-Authored-By: Claude Opus 4.6 (1M context) --- observability/respan.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/observability/respan.mdx b/observability/respan.mdx index d2a91220e..369f2ff2d 100644 --- a/observability/respan.mdx +++ b/observability/respan.mdx @@ -55,10 +55,10 @@ View your traces on the [Traces page](https://platform.respan.ai/platform/traces | Parameter | Type | Default | Description | | --------------------- | ------------- | ------------------------ | ---------------------------- | | `api_key` | `str` | `RESPAN_API_KEY` env var | Respan API key. | -| `endpoint` | `str \| None` | `None` | Custom ingest endpoint URL. | -| `base_url` | `str \| None` | `None` | API base URL. | -| `environment` | `str \| None` | `None` | Environment label. | -| `customer_identifier` | `str \| None` | `None` | Default customer identifier. | +| `endpoint` | `str | None` | `None` | Custom ingest endpoint URL. | +| `base_url` | `str | None` | `None` | API base URL. | +| `environment` | `str | None` | `None` | Environment label. | +| `customer_identifier` | `str | None` | `None` | Default customer identifier. | ## Notes