> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ja/llms.txt

# Observability

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

ファイルベースの規約については、このページを参照してください。シグナルモデル、Exporter、ストレージ、複数設定のセットアップについては、[Observability の概要](https://mastra.zisheng.pro/ja/docs/observability/overview)と [Observability の設定](https://mastra.zisheng.pro/ja/docs/observability/overview)を参照してください。

## クイックスタート

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

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

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

## Observability とストレージ

`observability.ts` は、収集するシグナルとそのエクスポート先を設定します。[`storage.ts`](https://mastra.zisheng.pro/ja/reference/file-based-agents/storage) は、Observability のレコードを永続化できるプロジェクトストアを設定します。シグナルごとのストレージ対応状況については、[Observability のシグナル対応状況](https://mastra.zisheng.pro/ja/docs/observability/overview)を参照してください。

## コードとの優先順位

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