> Discover all available pages from the documentation index: https://mastra.zisheng.pro/llms.txt

# ConsoleExporter

将 Trace 事件输出到控制台，用于调试和开发。

## 构造函数

```typescript
new ConsoleExporter(config?: BaseExporterConfig)
```

**config** (`BaseExporterConfig`): 配置选项

**config.logger** (`IMastraLogger`): Logger 实例（未设置时使用 INFO 级别的 ConsoleLogger）

**config.logLevel** (`LogLevel | 'debug' | 'info' | 'warn' | 'error'`): Exporter 的日志级别（默认值：INFO）

## 属性

```typescript
readonly name = 'tracing-console-exporter';
```

## 方法

### `exportTracingEvent`

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

将 Tracing 事件导出到控制台。

### shutdown

```typescript
async shutdown(): Promise<void>
```

记录关闭消息。

## 输出格式

Exporter 会根据事件类型输出不同格式：

### SPAN\_STARTED

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

### SPAN\_ENDED

```text
✅ 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

```text
📝 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]
────────────────────────────────────────
```

## 用法

```typescript
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 概览](https://mastra.zisheng.pro/docs/observability/tracing/overview)：完整指南
- [Exporter](https://mastra.zisheng.pro/docs/observability/integrations/overview)：Exporter 概念

### 其他 Exporter

- [MastraStorageExporter](https://mastra.zisheng.pro/reference/observability/tracing/exporters/mastra-storage-exporter)：存储持久化
- [MastraPlatformExporter](https://mastra.zisheng.pro/reference/observability/tracing/exporters/mastra-platform-exporter)：Mastra 平台
- [Langfuse](https://mastra.zisheng.pro/reference/observability/tracing/exporters/langfuse)：Langfuse 集成
- [Braintrust](https://mastra.zisheng.pro/reference/observability/tracing/exporters/braintrust)：Braintrust 集成

### 参考

- [配置](https://mastra.zisheng.pro/reference/observability/tracing/configuration)：配置选项
- [接口](https://mastra.zisheng.pro/reference/observability/tracing/interfaces)：类型定义