Skip to main content
npm version This module provides automatic instrumentation for LangChain.js, more specifically, the @langchain/core module. which may be used in conjunction with @opentelemetry/sdk-trace-node.

​
Install

npm install --save @arizeai/openinference-instrumentation-langchain

​
Setup

To load the LangChain instrumentation, manually instrument the @langchain/core/callbacks/manager module. The callbacks manager must be manually instrumented due to the non-traditional module structure in @langchain/core. Additional instrumentations can be registered as usual in the registerInstrumentations function. 
import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
import {
  LangChainInstrumentation
} from "@arizeai/openinference-instrumentation-langchain";
import * as CallbackManagerModule from "@langchain/core/callbacks/manager";

const provider = new NodeTracerProvider();
provider.register();

const lcInstrumentation = new LangChainInstrumentation();
// LangChain must be manually instrumented as it doesn't have
// a traditional module structure
lcInstrumentation.manuallyInstrument(CallbackManagerModule);

​
Support

Instrumentation version >1.0.0 supports both attribute masking and context attribute propagation to spans.
Instrumentation VersionLangChain ^0.3.0LangChain ^0.2.0LangChain ^0.1.0
>1.0.0✅✅✅
>0.2.0❌✅✅
>0.1.0❌❌✅

​
Custom Tracer Provider

You can specify a custom tracer provider for LangChain instrumentation in multiple ways:

​
Method 1: Pass tracerProvider on instantiation

const lcInstrumentation = new LangChainInstrumentation({
  tracerProvider: customTracerProvider,
});
lcInstrumentation.manuallyInstrument(CallbackManagerModule);

​
Method 2: Set tracerProvider after instantiation

const lcInstrumentation = new LangChainInstrumentation();
lcInstrumentation.setTracerProvider(customTracerProvider);
lcInstrumentation.manuallyInstrument(CallbackManagerModule);

​
Method 3: Pass tracerProvider to registerInstrumentations

const lcInstrumentation = new LangChainInstrumentation();
lcInstrumentation.manuallyInstrument(CallbackManagerModule);

registerInstrumentations({
  instrumentations: [lcInstrumentation],
  tracerProvider: customTracerProvider,
});

​
Resources