Observability インスタンス

DefaultObservabilityInstance

ObservabilityInstance インターフェースのデフォルト実装です。

コンストラクター

new DefaultObservabilityInstance(config: ObservabilityInstanceConfig)

指定した設定で新しい DefaultObservabilityInstance を作成します。

プロパティ

BaseObservabilityInstance のすべてのプロパティとメソッドを継承します。

BaseObservabilityInstance

カスタム ObservabilityInstance 実装の基底クラスです。

メソッド

getConfig

getConfig(): Readonly<Required<ObservabilityInstanceConfig>>

現在の observability 設定を返します。

getExporters

getExporters(): readonly ObservabilityExporter[]

設定済みのすべての exporter を返します。

getSpanOutputProcessors

getSpanOutputProcessors(): readonly SpanOutputProcessor[]

設定済みのすべての span output processor を返します。

getLogger

getLogger(): IMastraLogger

exporter やその他のコンポーネントで使用する logger インスタンスを返します。

startSpan

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

指定した SpanType の新しい span を開始します。親が指定されていない場合は、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 のライフサイクルとメソッド

Exporters

• MastraStorageExporter：ストレージへの永続化
• MastraPlatformExporter：Mastra プラットフォームとの統合
• ConsoleExporter：デバッグ出力