ConsoleExporter

Affiche les événements de Trace dans la console à des fins de débogage et de développement.

Constructeur

new ConsoleExporter(config?: BaseExporterConfig)

config?:

BaseExporterConfig

Options de configuration

BaseExporterConfig

logger?:

IMastraLogger

Instance du logger (utilise par défaut ConsoleLogger avec le niveau INFO)

logLevel?:

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

Niveau de log de l’exportateur (valeur par défaut : INFO)

Propriétés

readonly name = 'tracing-console-exporter';

Méthodes

exportTracingEvent

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

Exporte un événement de tracing vers la console.

shutdown

async shutdown(): Promise<void>

Enregistre un message d’arrêt dans les logs.

Format de sortie

L’exportateur produit différents formats selon le type d’événement :

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]
────────────────────────────────────────

Utilisation

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,
})

Détails de l’implémentation

• Formate les attributs en JSON avec une indentation de 2 espaces
• Calcule et affiche la durée des spans en millisecondes
• Gère proprement les erreurs de sérialisation
• Enregistre les types d’événements non implémentés comme avertissements
• Utilise des lignes de séparation de 80 caractères entre les événements

Voir aussi

Documentation

• Présentation du tracing : guide complet
• Exportateurs : concepts des exportateurs

Autres exportateurs

• MastraStorageExporter : persistance dans le stockage
• MastraPlatformExporter : plateforme Mastra
• Langfuse : intégration à Langfuse
• Braintrust : intégration à Braintrust

Référence

• Configuration : options de configuration
• Interfaces : définitions de types