Instances d’observabilité

DefaultObservabilityInstance

Implémentation par défaut de l’interface ObservabilityInstance.

Constructeur

new DefaultObservabilityInstance(config: ObservabilityInstanceConfig)

Crée une nouvelle instance de DefaultObservabilityInstance avec la configuration spécifiée.

Propriétés

Hérite de toutes les propriétés et méthodes de BaseObservabilityInstance.

BaseObservabilityInstance

Classe de base pour les implémentations personnalisées de ObservabilityInstance.

Méthodes

getConfig

getConfig(): Readonly<Required<ObservabilityInstanceConfig>>

Renvoie la configuration d’observabilité actuelle.

getExporters

getExporters(): readonly ObservabilityExporter[]

Renvoie tous les exportateurs configurés.

getSpanOutputProcessors

getSpanOutputProcessors(): readonly SpanOutputProcessor[]

Renvoie tous les processeurs de sortie des spans configurés.

getLogger

getLogger(): IMastraLogger

Renvoie l’instance du logger utilisée par les exportateurs et les autres composants.

startSpan

startSpan<TType extends SpanType>(
  options: StartSpanOptions<TType>
): Span<TType>

Démarre un nouveau span d’un SpanType donné. Crée le span racine d’une trace si aucun parent n’est fourni.

shutdown

async shutdown(): Promise<void>

Arrête tous les exportateurs et processeurs, puis libère les ressources.

Implémentation personnalisée

Pour créer une implémentation personnalisée de ObservabilityInstance, étendez BaseObservabilityInstance :

class CustomObservabilityInstance extends BaseObservabilityInstance {
  constructor(config: ObservabilityInstanceConfig) {
    super(config)
    // Custom initialization
  }

  // Override methods as needed
  startSpan<TType extends SpanType>(options: StartSpanOptions<TType>): Span<TType> {
    // Custom span creation logic
    return super.startSpan(options)
  }
}

Voir aussi

Documentation

• Présentation du tracing : concepts et guide d’utilisation
• Référence de la configuration : options de configuration
• Référence des interfaces : définitions de types
• Référence des spans : cycle de vie et méthodes des spans

Exportateurs

• MastraStorageExporter : persistance dans le stockage
• MastraPlatformExporter : intégration à la plateforme Mastra
• ConsoleExporter : sortie de débogage