可觀測性 instance

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 及其他元件使用的 logger instance。

startSpan

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

啟動指定 SpanType 的新 span。如未提供 parent，便會建立 Trace 的根 span。

shutdown

async shutdown(): Promise<void>

關閉所有 exporter 及 processor，並清理資源。

自訂實作

如要建立自訂 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：偵錯輸出