> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ko/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를 전달하고, 필드, 마스킹 토큰 또는 마스킹 스타일을 사용자 지정하려면 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 출력 프로세서입니다.

**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 데이터(입력/출력/속성)의 직렬화를 제어하는 옵션입니다.

**serializationOptions.maxStringLength** (`number`): 문자열 값의 최대 길이입니다(기본값: 1024).

**serializationOptions.maxDepth** (`number`): 중첩 객체의 최대 깊이입니다(기본값: 6).

**serializationOptions.maxArrayLength** (`number`): 배열의 최대 항목 수입니다(기본값: 50).

**serializationOptions.maxObjectKeys** (`number`): 객체의 최대 키 수입니다(기본값: 50).

**logging** (`{ enabled?: boolean; level?: LogLevel }`): Observability 저장소로의 로그 전달을 제어합니다. 자세한 내용은 Observability 저장소에 로깅을 참조하세요.

**logging.enabled** (`boolean`): Observability 저장소로의 로그 전달을 비활성화하려면 false로 설정합니다(기본값: 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;
```

관측 가능성 인스턴스를 레지스트리에 등록합니다.

### `getInstance`

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

이름으로 Observability 인스턴스를 검색합니다.

### `getDefaultInstance`

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

기본 관측 가능성 인스턴스를 반환합니다.

### `getSelectedInstance`

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

구성 선택기 또는 기본값으로 선택한 관측 가능성 인스턴스를 반환합니다.

### `listInstances`

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

등록된 모든 관측 가능성 인스턴스를 반환합니다.

### `hasInstance`

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

관측 가능성 인스턴스가 존재하는지 확인합니다.

### `setConfigSelector`

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

구성 선택기 기능을 설정합니다.

### `unregisterInstance`

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

레지스트리에서 Observability 인스턴스를 제거합니다.

### 분명한

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

종료하지 않고 모든 인스턴스를 지웁니다.

### 일시 휴업

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

모든 Observability 인스턴스를 종료하고 레지스트리를 지웁니다.

## 또한보십시오

### 선적 서류 비치

- [추적 개요](https://mastra.zisheng.pro/ko/docs/observability/tracing/overview): 개념 및 사용 가이드
- [샘플링 전략](https://mastra.zisheng.pro/ko/docs/observability/tracing/overview): 샘플링 구성 세부정보
- [다중 구성 설정](https://mastra.zisheng.pro/ko/docs/observability/overview): 여러 구성 사용

### 참조

- [추적 클래스](https://mastra.zisheng.pro/ko/reference/observability/tracing/instances): 핵심 추적 클래스
- [인터페이스](https://mastra.zisheng.pro/ko/reference/observability/tracing/interfaces): 유형 정의
- [스팬 참조](https://mastra.zisheng.pro/ko/reference/observability/tracing/spans): 스팬 수명주기

### 수출업체

- [MastraStorage수출업체](https://mastra.zisheng.pro/ko/reference/observability/tracing/exporters/mastra-storage-exporter): Mastra Storage에 대한 관측 가능성 이벤트를 지속합니다.
- [MastraPlatform수출자](https://mastra.zisheng.pro/ko/reference/observability/tracing/exporters/mastra-platform-exporter): 관측 가능성 이벤트를 Mastra 플랫폼으로 보냅니다.
- [브레인트러스트](https://mastra.zisheng.pro/ko/reference/observability/tracing/exporters/braintrust): Braintrust 통합
- [랭퓨즈](https://mastra.zisheng.pro/ko/reference/observability/tracing/exporters/langfuse): Langfuse 통합
- [랭스미스](https://mastra.zisheng.pro/ko/reference/observability/tracing/exporters/langsmith): LangSmith 통합
- [스팬 필터링](https://mastra.zisheng.pro/ko/reference/observability/tracing/span-filtering): 범위를 선택적으로 제외