PosthogExporter

Sends Tracing data to PostHog for AI observability and analytics.

Constructor

new PosthogExporter(config: PosthogExporterConfig)

PosthogExporterConfig

interface PosthogExporterConfig extends BaseExporterConfig {
  apiKey: string;
  host?: string;
  flushAt?: number;
  flushInterval?: number;
  serverless?: boolean;
  defaultDistinctId?: string;
  enablePrivacyMode?: boolean;
}

Extends BaseExporterConfig, which includes:

• logger?: IMastraLogger - Logger instance
• logLevel?: LogLevel | 'debug' | 'info' | 'warn' | 'error' - Log level (default: INFO)

Methods

exportTracingEvent

async exportTracingEvent(event: TracingEvent): Promise<void>

Exports a tracing event to PostHog.

shutdown

async shutdown(): Promise<void>

Flushes pending batched events and shuts down the PostHog client.

Usage

import { PosthogExporter } from "@mastra/posthog";

const exporter = new PosthogExporter({
  apiKey: process.env.POSTHOG_API_KEY!,
  host: "https://us.i.posthog.com",
  serverless: true,
});

Span Type Mapping

Mastra Span Type	PostHog Event Type
MODEL_GENERATION	$ai_generation
MODEL_STEP	$ai_generation
MODEL_CHUNK	$ai_span
TOOL_CALL	$ai_span
MCP_TOOL_CALL	$ai_span
PROCESSOR_RUN	$ai_span
AGENT_RUN	$ai_span
WORKFLOW_RUN	$ai_span
All other workflows	$ai_span
GENERIC	$ai_span