LangfuseExporter

Sends AI tracing data to Langfuse for observability.

ConstructorDirect link to Constructor

new LangfuseExporter(config: LangfuseExporterConfig)

LangfuseExporterConfigDirect link to LangfuseExporterConfig

interface LangfuseExporterConfig {
  publicKey?: string;
  secretKey?: string;
  baseUrl?: string;
  realtime?: boolean;
  logLevel?: "debug" | "info" | "warn" | "error";
  options?: any;
}

MethodsDirect link to Methods

exportEventDirect link to exportEvent

async exportEvent(event: AITracingEvent): Promise<void>

Exports a tracing event to Langfuse.

exportDirect link to export

async export(spans: ReadOnlyAISpan[]): Promise<void>

Batch exports spans to Langfuse.

shutdownDirect link to shutdown

async shutdown(): Promise<void>

Flushes pending data and shuts down the client.

UsageDirect link to Usage

import { LangfuseExporter } from "@mastra/langfuse";

const exporter = new LangfuseExporter({
  publicKey: process.env.LANGFUSE_PUBLIC_KEY,
  secretKey: process.env.LANGFUSE_SECRET_KEY,
  baseUrl: "https://cloud.langfuse.com",
  realtime: true,
});

Span MappingDirect link to Span Mapping

Root spans → Langfuse traces
MODEL_GENERATION spans → Langfuse generations
All other spans → Langfuse spans
Event spans → Langfuse events