Trace LangChain with BotGauge

Records LangChain LLM calls (model, prompts, token counts) and tool calls.


Extra	`[langchain]`
Verified framework versions	langchain 1.3.15 and 1.4.6
Instrumentor installed by the extra	`openinference-instrumentation-langchain 0.1.79`
Zero-code run	Traced

Also verified: langchain 1.3.15 with instrumentor 0.1.76. The extra no longer installs that older instrumentor. See supported frameworks for how verification works.

In code

Call tracing.init(), attach the framework instrumentor to the provider it returns, and wrap the work in tracing.turn() and tracing.agent().

Install

terminal

pip install "botgauge[langchain]" langchain==1.4.6 langchain-openai==1.7.2

Add the code

app.py

import os

from botgauge import tracing
from langchain_openai import ChatOpenAI
from openinference.instrumentation.langchain import LangChainInstrumentor

provider = tracing.init()
LangChainInstrumentor().instrument(tracer_provider=provider)

llm = ChatOpenAI(model=os.environ["OPENAI_MODEL"])

with tracing.turn(session_id="ses_langchain"), tracing.agent("langchain-agent"):
    reply = llm.invoke("In one sentence, what is OpenTelemetry?")
print(reply.text)

tracing.shutdown()

Run

terminal

python app.py

Needs BOTGAUGE_API_KEY, OPENAI_API_KEY, OPENAI_MODEL. Set OPENAI_BASE_URL too if your LLM isn’t api.openai.com.

Zero-code

Leave your app unchanged and start it with botgauge instrument. The sample still wraps the work in tracing.turn() and tracing.agent() so spans carry session and agent ids.

Install

terminal

pip install "botgauge[langchain]" langchain==1.4.6 langchain-openai==1.7.2

Add the code

app.py

import os

from botgauge import tracing
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(model=os.environ["OPENAI_MODEL"])

with tracing.turn(session_id="ses_langchain"), tracing.agent("langchain-agent"):
    reply = llm.invoke("In one sentence, what is OpenTelemetry?")
print(reply.text)

Run

terminal

botgauge instrument python app.py

Needs BOTGAUGE_API_KEY, OPENAI_API_KEY, OPENAI_MODEL. Set OPENAI_BASE_URL too if your LLM isn’t api.openai.com.

View LangChain spans live

Watch your LangChain LLM and tool calls appear in BotGauge.

Try BotGauge →

See versions not verified if you run a different version, capture and redaction to control exported content, and troubleshooting if spans are missing.

Frameworks

More

Trace LangChain with BotGauge

In code

Zero-code

​In code

​Zero-code

​Related

In code

Zero-code

Related