Skip to main content

Observability

Instrument your code with OpenTelemetry to capture traces, logs, and metrics for every LLM call, agent step, and tool use.

Observability

Getting Started

Deepset Haystack is a powerful framework for building RAG (Retrieval-Augmented Generation) pipelines and document search systems. Tracing Haystack with Orq.ai provides comprehensive insights into pipeline performance, component interactions, retrieval effectiveness, and answer generation quality to optimize your search and QA applications.

Prerequisites

Before you begin, ensure you have:
  • An Orq.ai account and API Key
  • Haystack 2.x installed in your project
  • Python 3.8+
  • API keys for your chosen LLM and embedding providers

Install Dependencies

Configure Orq.ai

Set up your environment variables to connect to Orq.ai’s OpenTelemetry collector: Unix/Linux/macOS:
Windows (PowerShell):
Using .env file:

Integrations

Choose your preferred OpenTelemetry framework for collecting traces, we’ll be using OpenLLMetry (Traceloop).

Examples

Advanced Pipeline with Custom Components

View Traces

To view Traces, head to the Traces tab in the Orq.ai studio. View Traces

Evaluations & Experiments

Once your agents are running, use Evaluatorq to score outputs across a dataset and Experiments to compare configurations side-by-side.

Run Evaluations with Evaluatorq

Run parallel evaluations across your agents and compare results.

Run Experiments via the API

Compare agent configurations and view results in the AI Studio.