LangChain and LangGraph observability

Overview

Laminar automatically instruments LangChain and LangGraph operations by simply initializing Laminar at the beginning of your Python application. This allows you to trace and monitor your LLM chains, agents, and graph-based workflows, providing complete visibility into your AI application’s performance, costs, and behavior without needing to modify your existing LangChain/LangGraph code.

Getting Started

1. Install Laminar and LangChain/LangGraph

You’ll need Laminar, LangChain core, any specific LangChain LLM/tool integrations (e.g., for OpenAI), and LangGraph:

pip install -U 'lmnr[all]' langchain langchain-openai langgraph python-dotenv
# Add other packages like langchain-community for specific tools if needed

2. Set up environment variables & Initialize Laminar

Store your API keys in a .env file and initialize Laminar once at the start of your application, before any LangChain or LangGraph code is executed.

from lmnr import Laminar
from dotenv import load_dotenv
import os
from langchain_openai import ChatOpenAI
from langchain_core.prompts import ChatPromptTemplate
from langchain_core.output_parsers import StrOutputParser
from langchain_core.messages import HumanMessage
from langgraph.graph import StateGraph, END
from typing import TypedDict, Annotated, Sequence
import operator

# Load environment variables from .env file
load_dotenv()

# Initialize Laminar - this single step enables automatic tracing
Laminar.initialize()

To see an example of how to integrate Laminar within a FastAPI application, check out our FastAPI integration guide.

3. Use LangChain and LangGraph as usual

LangChain Example (Simple LLMChain):

# Ensure Laminar.initialize() was called as shown in Step 2.

model = ChatOpenAI()
prompt = ChatPromptTemplate.from_messages([
    ("system", "You are a helpful assistant."),
    ("human", "{question}")
])
output_parser = StrOutputParser()

chain = prompt | model | output_parser

# response = chain.invoke({"question": "What is the capital of France?"})
# print(response)

LangGraph Example (Simple Graph):

# Ensure Laminar.initialize() was called as shown in Step 2.

class AgentState(TypedDict):
    messages: Annotated[Sequence[HumanMessage], operator.add]

llm = ChatOpenAI()

def call_model(state: AgentState):
    messages = state['messages']
    response = llm.invoke(messages)
    return {"messages": [response]} # Append new message

# Define a new graph
workflow = StateGraph(AgentState)
workflow.add_node("agent", call_model)
workflow.set_entry_point("agent")
workflow.add_edge("agent", END)

app = workflow.compile()

# inputs = {"messages": [HumanMessage(content="Hi there!")]}
# result = app.invoke(inputs)
# print(result['messages'][-1].content)

All instrumentable LangChain and LangGraph operations are now automatically traced in Laminar.

Monitoring LangChain usage

After instrumenting your LangChain and LangGraph applications with Laminar, you’ll be able to:

View detailed traces of each chain, agent step, tool usage, and LLM call.
Track token usage and cost across different models used within LangChain.
Monitor latency and performance metrics for individual components and overall workflows.
Analyze prompt engineering by inspecting inputs/outputs at each step.
Debug issues with complex chains or graphs by visualizing their execution flow.

Visit your Laminar dashboard to view your LangChain traces and analytics.

Enrich your LangChain traces

Attach sessions, user IDs, metadata, and tags to LangChain spans via the SDK reference.
Wrap the functions around your chains and graphs with observe and mark them as TOOL spans so they show up in the transcript.

deepagents

Trace deepagents runs, subagents, and tool calls.

Pydantic AI

Trace Pydantic AI agent runs and typed tool calls.

LiteLLM

One integration for every model LiteLLM routes to.

OpenAI

Trace the OpenAI SDK directly in TypeScript and Python.

Langfuse

Keep Langfuse and send the same spans to Laminar too.

All integrations

Browse every provider, framework, coding agent, and browser integration Laminar supports.

Overview

LLM provider SDKs

Agent frameworks

Coding agents

Browser and computer-use agents

Other platforms

OpenTelemetry

LangChain and LangGraph observability

Overview

Getting Started

1. Install Laminar and LangChain/LangGraph

2. Set up environment variables & Initialize Laminar

3. Use LangChain and LangGraph as usual

Monitoring LangChain usage

Enrich your LangChain traces

deepagents

Pydantic AI

LiteLLM

OpenAI

Langfuse

All integrations

​Overview

​Getting Started

​1. Install Laminar and LangChain/LangGraph

​2. Set up environment variables & Initialize Laminar

​3. Use LangChain and LangGraph as usual

​Monitoring LangChain usage

​Enrich your LangChain traces

​Related integrations

deepagents

Pydantic AI

LiteLLM

OpenAI

Langfuse

All integrations

Overview

Getting Started

1. Install Laminar and LangChain/LangGraph

2. Set up environment variables & Initialize Laminar

3. Use LangChain and LangGraph as usual

Monitoring LangChain usage

Enrich your LangChain traces

Related integrations