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

# 設定

## `ObservabilityRegistryConfig`

```typescript
interface ObservabilityRegistryConfig {
  default?: { enabled?: boolean }
  configs?: Record<string, Omit<ObservabilityInstanceConfig, 'name'> | ObservabilityInstance>
  configSelector?: ConfigSelector
  sensitiveDataFilter?: boolean | SensitiveDataFilterOptions
}
```

**default** (`{ enabled?: boolean }`): MastraStorageExporter と MastraPlatformExporter を使用するデフォルト設定を有効にします

**configs** (`Record<string, Omit<ObservabilityInstanceConfig, 'name'> | ObservabilityInstance>`): 名前付き Observability インスタンス設定、または事前生成済みインスタンス

**configSelector** (`ConfigSelector`): ランタイム設定セレクター関数

**sensitiveDataFilter** (`boolean | SensitiveDataFilterOptions`): 設定済みの各インスタンスへ SensitiveDataFilter を自動適用するか制御します。デフォルトは true です。無効にするには false を渡し、フィールド、墨消し token、または墨消し形式をカスタマイズするには SensitiveDataFilterOptions オブジェクトを渡します。設定の spanOutputProcessors に SensitiveDataFilter がすでに含まれる場合、重複して追加されません。事前生成済みインスタンスは変更されません。

## `ObservabilityInstanceConfig`

```typescript
interface ObservabilityInstanceConfig {
  name: string
  serviceName: string
  sampling?: SamplingStrategy
  exporters?: ObservabilityExporter[]
  spanOutputProcessors?: SpanOutputProcessor[]
  includeInternalSpans?: boolean
  excludeSpanTypes?: SpanType[]
  spanFilter?: (span: AnyExportedSpan) => boolean
  requestContextKeys?: string[]
  serializationOptions?: SerializationOptions
  logging?: { enabled?: boolean; level?: LogLevel }
}
```

**name** (`string`): 設定識別子

**serviceName** (`string`): Trace 内のサービス名

**sampling** (`SamplingStrategy`): サンプリング設定（デフォルト：ALWAYS）

**exporters** (`ObservabilityExporter[]`): Trace データの exporter

**spanOutputProcessors** (`SpanOutputProcessor[]`): Span 出力 processor

**includeInternalSpans** (`boolean`): Mastra の処理内部の Span を含めます

**excludeSpanTypes** (`SpanType[]`): エクスポートから除外する Span タイプ。Span 単位で課金されるプラットフォームのノイズとコストの削減に役立ちます。詳細は Span フィルタリングのリファレンスを参照してください。

**spanFilter** (`(span: AnyExportedSpan) => boolean`): エクスポートする Span を制御するフィルター関数。保持する場合は true、破棄する場合は false を返します。excludeSpanTypes と spanOutputProcessors の後に実行されます。詳細は Span フィルタリングのリファレンスを参照してください。

**requestContextKeys** (`string[]`): メタデータとして抽出する RequestContext キー（ドット記法をサポート）

**serializationOptions** (`SerializationOptions`): Span データ（input/output/attributes）のシリアライズを制御するオプション

**serializationOptions.maxStringLength** (`number`): 文字列値の最大長（デフォルト：1024）

**serializationOptions.maxDepth** (`number`): ネストしたオブジェクトの最大深度（デフォルト：6）

**serializationOptions.maxArrayLength** (`number`): 配列内の最大要素数（デフォルト：50）

**serializationOptions.maxObjectKeys** (`number`): オブジェクト内の最大キー数（デフォルト：50）

**logging** (`{ enabled?: boolean; level?: LogLevel }`): Observability storage へのログ転送を制御します。詳細は Observability storage へのログ記録を参照してください。

**logging.enabled** (`boolean`): false に設定すると Observability storage へのログ転送を無効にします（デフォルト：true）

**logging.level** (`LogLevel`): 転送する最小ログレベル。'debug'、'info'、'warn'、'error'、'fatal' のいずれか（デフォルト：'debug'）

## `SamplingStrategy`

```typescript
type SamplingStrategy =
  | { type: 'always' }
  | { type: 'never' }
  | { type: 'ratio'; probability: number }
  | { type: 'custom'; sampler: (options?: TracingOptions) => boolean }
```

## `ConfigSelector`

```typescript
type ConfigSelector = (
  options: ConfigSelectorOptions,
  availableConfigs: ReadonlyMap<string, ObservabilityInstance>,
) => string | undefined
```

## `ConfigSelectorOptions`

```typescript
interface ConfigSelectorOptions {
  requestContext?: RequestContext
}
```

## レジストリメソッド

Observability クラスは、Observability インスタンスを管理するためのメソッドを提供します。

### `registerInstance`

```typescript
registerInstance(
  name: string,
  instance: ObservabilityInstance,
  isDefault?: boolean
): void;
```

Observability インスタンスをレジストリに登録します。

### `getInstance`

```typescript
getInstance(name: string): ObservabilityInstance | undefined;
```

名前で Observability インスタンスを取得します。

### `getDefaultInstance`

```typescript
getDefaultInstance(): ObservabilityInstance | undefined;
```

デフォルトの Observability インスタンスを返します。

### `getSelectedInstance`

```typescript
getSelectedInstance(
  options: ConfigSelectorOptions
): ObservabilityInstance | undefined;
```

設定セレクターで選択された Observability インスタンス、またはデフォルトのインスタンスを返します。

### `listInstances`

```typescript
listInstances(): ReadonlyMap<string, ObservabilityInstance>;
```

登録済みのすべての Observability インスタンスを返します。

### `hasInstance`

```typescript
hasInstance(name: string): boolean;
```

Observability インスタンスが存在するか確認します。

### `setConfigSelector`

```typescript
setConfigSelector(selector: ConfigSelector): void;
```

設定セレクター関数を設定します。

### `unregisterInstance`

```typescript
unregisterInstance(name: string): boolean;
```

Observability インスタンスをレジストリから削除します。

### clear

```typescript
clear(): void;
```

シャットダウンせずにすべてのインスタンスを消去します。

### shutdown

```typescript
async shutdown(): Promise<void>;
```

すべての Observability インスタンスをシャットダウンし、レジストリを消去します。

## 関連項目

### ドキュメント

- [Tracing の概要](https://mastra.zisheng.pro/ja/docs/observability/tracing/overview): 概念と使用ガイド
- [サンプリング戦略](https://mastra.zisheng.pro/ja/docs/observability/tracing/overview): サンプリング設定の詳細
- [複数設定のセットアップ](https://mastra.zisheng.pro/ja/docs/observability/overview): 複数設定の使用

### リファレンス

- [Tracing クラス](https://mastra.zisheng.pro/ja/reference/observability/tracing/instances): 主要な Tracing クラス
- [インターフェース](https://mastra.zisheng.pro/ja/reference/observability/tracing/interfaces): 型定義
- [Spans リファレンス](https://mastra.zisheng.pro/ja/reference/observability/tracing/spans): Span のライフサイクル

### Exporters

- [MastraStorageExporter](https://mastra.zisheng.pro/ja/reference/observability/tracing/exporters/mastra-storage-exporter): Observability イベントを Mastra Storage に永続化
- [MastraPlatformExporter](https://mastra.zisheng.pro/ja/reference/observability/tracing/exporters/mastra-platform-exporter): Observability イベントを Mastra プラットフォームへ送信
- [Braintrust](https://mastra.zisheng.pro/ja/reference/observability/tracing/exporters/braintrust): Braintrust 連携
- [Langfuse](https://mastra.zisheng.pro/ja/reference/observability/tracing/exporters/langfuse): Langfuse 連携
- [LangSmith](https://mastra.zisheng.pro/ja/reference/observability/tracing/exporters/langsmith): LangSmith 連携
- [Span フィルタリング](https://mastra.zisheng.pro/ja/reference/observability/tracing/span-filtering): Span を選択的に除外