Observability 实例

DefaultObservabilityInstance

ObservabilityInstance 接口的默认实现。

构造函数

new DefaultObservabilityInstance(config: ObservabilityInstanceConfig)

使用指定配置创建新的 DefaultObservabilityInstance。

属性

继承 BaseObservabilityInstance 的所有属性和方法。

BaseObservabilityInstance

自定义 ObservabilityInstance 实现的基类。

方法

getConfig

getConfig(): Readonly<Required<ObservabilityInstanceConfig>>

返回当前的可观测性配置。

getExporters

getExporters(): readonly ObservabilityExporter[]

返回所有已配置的 Exporter。

getSpanOutputProcessors

getSpanOutputProcessors(): readonly SpanOutputProcessor[]

返回所有已配置的 Span 输出处理器。

getLogger

getLogger(): IMastraLogger

返回供 Exporter 和其他组件使用的日志记录器实例。

startSpan

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

启动指定 SpanType 的新 Span。如果未提供父 Span，则创建 Trace 的根 Span。

shutdown

async shutdown(): Promise<void>

关闭所有 Exporter 和处理器，并清理资源。

自定义实现

要创建自定义 ObservabilityInstance 实现，请扩展 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)
  }
}

另请参阅

文档

• Tracing 概览：概念和使用指南
• 配置参考：配置选项
• 接口参考：类型定义
• Span 参考：Span 生命周期和方法

Exporter

• MastraStorageExporter：存储持久化
• MastraPlatformExporter：Mastra 平台集成
• ConsoleExporter：调试输出