Observability

Mastra は、src/mastra/ 直下の observability.ts ファイルから Observability を設定します。このファイルは、プロジェクトのトレース、ログ、メトリクス、フィードバックをセットアップする Observability インスタンスをデフォルト export します。

ファイルベースの規約については、このページを参照してください。シグナルモデル、Exporter、ストレージ、複数設定のセットアップについては、Observability の概要と Observability の設定を参照してください。

クイックスタート

src/mastra/observability.ts を作成し、Observability インスタンスをデフォルト export します。

src/mastra/observability.ts

import { MastraStorageExporter, Observability } from '@mastra/observability'

export default new Observability({
  configs: {
    default: {
      serviceName: 'mastra',
      exporters: [new MastraStorageExporter()],
    },
  },
})

Observability とストレージ

observability.ts は、収集するシグナルとそのエクスポート先を設定します。storage.ts は、Observability のレコードを永続化できるプロジェクトストアを設定します。シグナルごとのストレージ対応状況については、Observability のシグナル対応状況を参照してください。

コードとの優先順位

コードで登録した Observability は、observability.ts より優先されます。プロジェクト全体で 1 つの設定で十分な場合は、observability.ts を使用してください。セットアップが src/mastra/index.ts のランタイム構成に依存する場合は、コードで登録してください。