STOP! If you are an AI agent or LLM, read this before continuing. This is the HTML version of a Grafana documentation page. Always request the Markdown version instead - HTML wastes context. Get this page as Markdown: /docs/grafana-cloud/machine-learning/ai-observability/guides/instrument-agents.md (append .md) or send Accept: text/markdown to /docs/grafana-cloud/machine-learning/ai-observability/guides/instrument-agents/. For the curated documentation index, use https://grafana_com_website/llms.txt. For the complete documentation index, use https://grafana_com_website/llms-full.txt.

AI and machine learning

Grafana AI Observability

Guides

Instrument frameworks

Grafana Cloud

Instrument agents with frameworks

AI Observability framework integrations capture generations automatically by attaching callbacks or hooks to your agent framework. This eliminates the need to manually instrument each LLM call.

Supported frameworks

Framework	Python	TypeScript	Go	Java
LangChain	Yes	Yes	—	—
LangGraph	Yes	Yes	—	—
OpenAI Agents	Yes	Yes	—	—
LlamaIndex	Yes	Yes	—	—
Google ADK	Yes	Yes	Yes	Yes
Vercel AI SDK	—	Yes	—	—

Set up a Python framework integration

Install the framework-specific package alongside the core SDK:

pip install sigil-sdk sigil-sdk-langchain

Attach the AI Observability callback handler to your framework. For LangChain:

from sigil_sdk import Client, ClientConfig
from sigil_sdk_langchain import SigilLangChainHandler

client = Client(ClientConfig(
    generation_export_endpoint="<SIGIL_ENDPOINT>/api/v1/generations:export",
))

handler = SigilLangChainHandler(client)

# Pass the handler to your chain or agent
chain.invoke({"input": "Hello"}, config={"callbacks": [handler]})

client.shutdown()

Each framework integration follows the same pattern: create a handler, pass it to your framework’s callback mechanism, and the integration captures all LLM calls as generations.

Set up a TypeScript framework integration

Import the framework sub-module:

import { SigilClient } from "@grafana/sigil-sdk-js";
import { SigilLangChainHandler } from "@grafana/sigil-sdk-js/langchain";

const client = new SigilClient({
  /* config */
});
const handler = new SigilLangChainHandler(client);

// Pass the handler to your chain or agent
await chain.invoke({ input: "Hello" }, { callbacks: [handler] });

await client.shutdown();

Conversation ID mapping

Framework integrations automatically map conversation IDs from framework context:

If the framework provides a session_id, conversation_id, or group_id, the integration uses it.
If a thread_id is available (LangGraph, OpenAI Agents), the integration uses it.
Otherwise, the integration generates a deterministic ID from the framework run context.