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

# 可觀測性執行個體

## `DefaultObservabilityInstance`

ObservabilityInstance 介面的預設實作。

### 建構函式

```typescript
new DefaultObservabilityInstance(config: ObservabilityInstanceConfig)
```

使用指定設定建立新的 DefaultObservabilityInstance。

### 屬性

繼承 BaseObservabilityInstance 的所有屬性與方法。

## `BaseObservabilityInstance`

自訂 ObservabilityInstance 實作的基底類別。

### 方法

#### `getConfig`

```typescript
getConfig(): Readonly<Required<ObservabilityInstanceConfig>>
```

傳回目前的可觀測性設定。

#### `getExporters`

```typescript
getExporters(): readonly ObservabilityExporter[]
```

傳回所有已設定的 exporter。

#### `getSpanOutputProcessors`

```typescript
getSpanOutputProcessors(): readonly SpanOutputProcessor[]
```

傳回所有已設定的 span 輸出 processor。

#### `getLogger`

```typescript
getLogger(): IMastraLogger
```

傳回供 exporter 與其他元件使用的 logger 執行個體。

#### `startSpan`

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

啟動指定 SpanType 的新 span。若未提供父 span，則建立 trace 的根 span。

#### shutdown

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

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

## 自訂實作

若要建立自訂 ObservabilityInstance 實作，請擴充 BaseObservabilityInstance：

```typescript
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 概覽](https://mastra.zisheng.pro/zh-TW/docs/observability/tracing/overview)：概念與使用指南
- [設定參考](https://mastra.zisheng.pro/zh-TW/reference/observability/tracing/configuration)：設定選項
- [介面參考](https://mastra.zisheng.pro/zh-TW/reference/observability/tracing/interfaces)：型別定義
- [Span 參考](https://mastra.zisheng.pro/zh-TW/reference/observability/tracing/spans)：span 生命週期與方法

### Exporter

- [MastraStorageExporter](https://mastra.zisheng.pro/zh-TW/reference/observability/tracing/exporters/mastra-storage-exporter)：儲存持久化
- [MastraPlatformExporter](https://mastra.zisheng.pro/zh-TW/reference/observability/tracing/exporters/mastra-platform-exporter)：Mastra platform 整合
- [ConsoleExporter](https://mastra.zisheng.pro/zh-TW/reference/observability/tracing/exporters/console-exporter)：偵錯輸出