ConsoleExporter

將 trace 事件輸出至 console，以供偵錯與開發使用。

建構函式

new ConsoleExporter(config?: BaseExporterConfig)

config?:

BaseExporterConfig

設定選項

BaseExporterConfig

logger?:

IMastraLogger

Logger 執行個體（若未設定，則使用 INFO 層級的 ConsoleLogger）

logLevel?:

LogLevel | 'debug' | 'info' | 'warn' | 'error'

Exporter 的 log 層級（預設：INFO）

屬性

readonly name = 'tracing-console-exporter';

方法

exportTracingEvent

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

將 tracing 事件匯出至 console。

shutdown

async shutdown(): Promise<void>

記錄關閉訊息。

輸出格式

Exporter 會根據事件類型輸出不同格式：

SPAN_STARTED

🚀 SPAN_STARTED
   Type: [span type]
   Name: [span name]
   ID: [span id]
   Trace ID: [trace id]
   Input: [formatted input]
   Attributes: [formatted attributes]
────────────────────────────────────────

SPAN_ENDED

✅ SPAN_ENDED
   Type: [span type]
   Name: [span name]
   ID: [span id]
   Duration: [duration]ms
   Trace ID: [trace id]
   Input: [formatted input]
   Output: [formatted output]
   Error: [formatted error if present]
   Attributes: [formatted attributes]
────────────────────────────────────────

SPAN_UPDATED

📝 SPAN_UPDATED
   Type: [span type]
   Name: [span name]
   ID: [span id]
   Trace ID: [trace id]
   Input: [formatted input]
   Output: [formatted output]
   Error: [formatted error if present]
   Updated Attributes: [formatted attributes]
────────────────────────────────────────

使用方式

import { ConsoleExporter } from '@mastra/observability'
import { ConsoleLogger, LogLevel } from '@mastra/core/logger'

// Use default logger (INFO level)
const exporter = new ConsoleExporter()

// Use custom log level
const exporter = new ConsoleExporter({
  logLevel: 'debug',
})

// Use custom logger instance
const customLogger = new ConsoleLogger({ level: LogLevel.DEBUG })
const exporterWithLogger = new ConsoleExporter({
  logger: customLogger,
})

實作詳細資料

• 將屬性格式化為縮排 2 個空格的 JSON
• 計算並顯示 span 持續時間（毫秒）
• 妥善處理序列化錯誤
• 將尚未實作的事件類型記錄為警告
• 事件之間使用 80 個字元的分隔線

另請參閱

文件

• Tracing 概覽：完整指南
• Exporter：Exporter 概念

其他 Exporter

• MastraStorageExporter：儲存持久化
• MastraPlatformExporter：Mastra platform
• Langfuse：Langfuse 整合
• Braintrust：Braintrust 整合

參考

• 設定：設定選項
• 介面：型別定義