Skip to main content

PosthogExporter

将跟踪数据发送到 PostHog，用于 AI 可观测性和分析。

🌐 Sends Tracing data to PostHog for AI observability and analytics.

构造函数
Direct link to 构造函数

🌐 Constructor

new PosthogExporter(config: PosthogExporterConfig)

PosthogExporterConfig
Direct link to PosthogExporterConfig

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

扩展自 BaseExporterConfig，包括：

🌐 Extends BaseExporterConfig, which includes:

  • logger?: IMastraLogger - 记录器实例
  • logLevel?: LogLevel | 'debug' | 'info' | 'warn' | 'error' - 日志级别（默认：INFO）

方法
Direct link to 方法

🌐 Methods

exportTracingEvent
Direct link to exportTracingEvent

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

将跟踪事件导出到 PostHog。

🌐 Exports a tracing event to PostHog.

flush
Direct link to flush

async flush(): Promise<void>

强制将任何缓冲的事件刷新到 PostHog，而不关闭导出器。在无服务器环境中非常有用，可以确保在运行时终止之前导出跨度。

🌐 Force flushes any buffered events to PostHog without shutting down the exporter. Useful in serverless environments where you need to ensure spans are exported before the runtime terminates.

shutdown
Direct link to shutdown

async shutdown(): Promise<void>

刷新待处理的批量事件并关闭 PostHog 客户端。

🌐 Flushes pending batched events and shuts down the PostHog client.

用法
Direct link to 用法

🌐 Usage

零配置（使用环境变量）
Direct link to 零配置（使用环境变量）

🌐 Zero-Config (using environment variables)

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

// Reads from POSTHOG_API_KEY, POSTHOG_HOST
const exporter = new PosthogExporter();

显式配置
Direct link to 显式配置

🌐 Explicit Configuration

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

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

跨度类型映射
Direct link to 跨度类型映射

🌐 Span Type Mapping

Mastra 跨度类型PostHog 事件类型
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
所有其他工作流程$ai_span
GENERIC$ai_span
目录