> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ja/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/ja/docs/observability/tracing/overview)：完全ガイド
- [Exporters](https://mastra.zisheng.pro/ja/docs/observability/integrations/overview)：exporter の概念

### その他の Exporter

- [MastraStorageExporter](https://mastra.zisheng.pro/ja/reference/observability/tracing/exporters/mastra-storage-exporter)：ストレージへの永続化
- [MastraPlatformExporter](https://mastra.zisheng.pro/ja/reference/observability/tracing/exporters/mastra-platform-exporter)：Mastra プラットフォーム
- [Langfuse](https://mastra.zisheng.pro/ja/reference/observability/tracing/exporters/langfuse)：Langfuse との統合
- [Braintrust](https://mastra.zisheng.pro/ja/reference/observability/tracing/exporters/braintrust)：Braintrust との統合

### リファレンス

- [設定](https://mastra.zisheng.pro/ja/reference/observability/tracing/configuration)：設定オプション
- [インターフェース](https://mastra.zisheng.pro/ja/reference/observability/tracing/interfaces)：型定義