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

# Observability 实例

## `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 输出处理器。

#### `getLogger`

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

返回供 Exporter 和其他组件使用的日志记录器实例。

#### `startSpan`

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

启动指定 SpanType 的新 Span。如果未提供父 Span，则创建 Trace 的根 Span。

#### shutdown

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

关闭所有 Exporter 和处理器，并清理资源。

## 自定义实现

要创建自定义 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/docs/observability/tracing/overview)：概念和使用指南
- [配置参考](https://mastra.zisheng.pro/reference/observability/tracing/configuration)：配置选项
- [接口参考](https://mastra.zisheng.pro/reference/observability/tracing/interfaces)：类型定义
- [Span 参考](https://mastra.zisheng.pro/reference/observability/tracing/spans)：Span 生命周期和方法

### Exporter

- [MastraStorageExporter](https://mastra.zisheng.pro/reference/observability/tracing/exporters/mastra-storage-exporter)：存储持久化
- [MastraPlatformExporter](https://mastra.zisheng.pro/reference/observability/tracing/exporters/mastra-platform-exporter)：Mastra 平台集成
- [ConsoleExporter](https://mastra.zisheng.pro/reference/observability/tracing/exporters/console-exporter)：调试输出