LlamaIndex

Overview

This guide shows you how to integrate Latitude Telemetry into an application that uses LlamaIndex.

You’ll keep calling LlamaIndex exactly as you do today. Telemetry simply observes and enriches those calls.

Requirements

A Latitude account and API key
A Latitude project slug
A project that uses LlamaIndex

Steps

Install

TypeScript
Python

npm install @latitude-data/telemetry

pnpm add @latitude-data/telemetry

yarn add @latitude-data/telemetry

bun add @latitude-data/telemetry

pip install latitude-telemetry

uv add latitude-telemetry

poetry add latitude-telemetry

Initialize and use

TypeScript
Python

import { Latitude, capture } from "@latitude-data/telemetry"
import { Settings } from "llamaindex"
import * as LlamaIndex from "llamaindex"
import { openai } from "@llamaindex/openai"
import { agent } from "@llamaindex/workflow"

const latitude = new Latitude({
  apiKey: process.env.LATITUDE_API_KEY!,
  project: process.env.LATITUDE_PROJECT_SLUG!,
  instrumentations: { llamaindex: LlamaIndex },
})


Settings.llm = openai({ model: "gpt-4o" })
const myAgent = agent({ tools: [] })

await capture("llamaindex-query", async () => {
  const response = await myAgent.run("Hello")
  return response
})

await latitude.shutdown()

import llama_index
from llama_index.core import VectorStoreIndex, SimpleDirectoryReader

from latitude_telemetry import Latitude, capture

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

documents = SimpleDirectoryReader("data").load_data()
index = VectorStoreIndex.from_documents(documents)
query_engine = index.as_query_engine()

def llamaindex_query():
    response = query_engine.query("What is this document about?")
    return str(response)

capture("llamaindex-query", llamaindex_query)

latitude.shutdown()

Seeing Your Traces

Once connected, traces appear automatically in Latitude:

Open your project in the Latitude dashboard
Each execution shows input/output messages, model, token usage, latency, and errors
LlamaIndex retrieval and synthesis steps appear as child spans

LangChain CrewAI

⌘I

Overview

Getting Started

Observe

Understand

Refine

Security and Compliance

Deployment

Development

More

Overview

Requirements

Steps

Seeing Your Traces

​Overview

​Requirements

​Steps

​Seeing Your Traces

Overview

Requirements

Steps

Seeing Your Traces