Haystack

Install the `latitude-setup` skill from `github.com/latitude-dev/skills` and use it to set up Latitude tracing here.

​

Overview

​

Requirements

• A Latitude account and API key, or none yet: your agent can create a temporary account with the latitude-setup skill, no signup
• A Latitude project slug
• A project that uses Haystack (haystack-ai)
• A model provider key — the example below uses OpenAI (OPENAI_API_KEY)

​

Steps

pip install latitude-telemetry haystack-ai

uv add latitude-telemetry haystack-ai

poetry add latitude-telemetry haystack-ai

import haystack
from haystack.components.generators.chat import OpenAIChatGenerator
from haystack.dataclasses import ChatMessage

from latitude_telemetry import Latitude, capture

latitude = Latitude(
    api_key="your-api-key",
    project="your-project-slug",
    instrumentations={"haystack": haystack},
)

def chat():
    generator = OpenAIChatGenerator(model="gpt-4o-mini")
    result = generator.run(messages=[ChatMessage.from_user("Hello")])
    return result["replies"][0].text

capture("haystack-chat", chat)

latitude.shutdown()

​

What you get

• Pipeline / component spans — the components that ran and their configuration
• Generation spans — model, input/output messages, and token usage
• Tool spans — tool calls with input arguments and output

​

Seeing Your Traces

1. Open your project in the Latitude dashboard
2. Each run shows the full hierarchy of component → generation → tool calls
3. Token usage and latency are aggregated at every level

​

See what was captured

Build my first Latitude Artifact from the session that just landed, using the first-artifact.html template from the latitude-setup skill (github.com/latitude-dev/skills).