LangChainRust provides a callback system for observability, tracing, and monitoring with handlers for console, file, LangSmith, and OpenTelemetry.
Component Description
CallbackHandlerTrait with lifecycle hooks (LLM, chain, tool, retriever)
CallbackManagerManages multiple handlers, dispatches events
RunTreeStructured run tracking with parent-child relationships
RunTypeLlm, Chain, Tool, Retriever, Embedding, Prompt, Parser
Handler Struct Output
Console StdOutHandlerPrints to stdout
File FileCallbackHandlerWrites to file (Plain/JSON/JSONLines)
LangSmith LangSmithHandlerSends to LangSmith platform
OpenTelemetry OtelHandlerEmits OTel spans with GenAI SemConv
#![allow(unused)]
fn main() {
use langchainrust::{
CallbackManager, StdOutHandler, FileCallbackHandler,
LangSmithHandler, LogFormat,
};
use std::sync::Arc;
let manager = CallbackManager::new()
.add_handler(Arc::new(StdOutHandler::new()))
.add_handler(Arc::new(FileCallbackHandler::new("./traces.jsonl")?
.with_format(LogFormat::JsonLines)))
.add_handler(Arc::new(LangSmithHandler::from_env()?));
}
Environment variables:
Variable Description Default
LANGSMITH_API_KEYAPI key (starts with ls_) Required
LANGSMITH_TRACINGEnable tracing true
LANGSMITH_PROJECTProject name default
LANGSMITH_ENDPOINTAPI endpoint LangSmith official
LANGSMITH_WORKSPACE_IDWorkspace ID For org accounts
#![allow(unused)]
fn main() {
// Feature: opentelemetry
use langchainrust::OtelHandler;
let handler = OtelHandler::from_global("langchainrust");
// Sets GenAI Semantic Convention attributes:
// gen_ai.system, gen_ai.request.model, gen_ai.response.model,
// gen_ai.response.finish_reason, gen_ai.client.token.usage.*,
// gen_ai.request.max_tokens, gen_ai.request.temperature,
// gen_ai.operation.name, gen_ai.tool.name
}
#![allow(unused)]
fn main() {
use langchainrust::{Tracer, SpanKind, SpanGuard, InMemoryTracingBackend};
let backend = Arc::new(InMemoryTracingBackend::new());
let tracer = Tracer::new(backend.clone());
let mut span = tracer.start("llm_call", SpanKind::Llm);
span.with_tokens(SpanTokenUsage { prompt_tokens: 10, completion_tokens: 20, total_tokens: 30 });
span.end(); // RAII: ends on drop if not called
// Inspect traces
let spans = backend.spans();
}
#![allow(unused)]
fn main() {
use langchainrust::{RunTree, RunType};
let run = RunTree::new("my_chain", RunType::Chain, serde_json::json!({"input": "hello"}))
.with_tag("production")
.with_project("my-project");
let child = run.create_child("llm_step", RunType::Llm, serde_json::json!({"prompt": "..."}));
}