구성

ObservabilityRegistryConfig

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

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).

maxDepth?:

number

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

maxArrayLength?:

number

배열의 최대 항목 수입니다(기본값: 50).

maxObjectKeys?:

number

객체의 최대 키 수입니다(기본값: 50).

logging:

{ enabled?: boolean; level?: LogLevel }

Observability 저장소로의 로그 전달을 제어합니다. 자세한 내용은 Observability 저장소에 로깅을 참조하세요.

{ enabled?: boolean; level?: LogLevel }

enabled?:

boolean

Observability 저장소로의 로그 전달을 비활성화하려면 false로 설정합니다(기본값: true).

level?:

LogLevel

전달할 최소 로그 수준입니다. 'debug', 'info', 'warn', 'error', 'fatal' 중 하나입니다(기본값: 'debug').

SamplingStrategy

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

ConfigSelector

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

ConfigSelectorOptions

interface ConfigSelectorOptions {
  requestContext?: RequestContext
}

레지스트리 방법

Observability 클래스는 Observability 인스턴스를 관리하기 위한 메서드를 제공합니다.

registerInstance

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

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

getInstance

getInstance(name: string): ObservabilityInstance | undefined;

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

getDefaultInstance

getDefaultInstance(): ObservabilityInstance | undefined;

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

getSelectedInstance

getSelectedInstance(
  options: ConfigSelectorOptions
): ObservabilityInstance | undefined;

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

listInstances

listInstances(): ReadonlyMap<string, ObservabilityInstance>;

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

hasInstance

hasInstance(name: string): boolean;

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

setConfigSelector

setConfigSelector(selector: ConfigSelector): void;

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

unregisterInstance

unregisterInstance(name: string): boolean;

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

분명한

clear(): void;

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

일시 휴업

async shutdown(): Promise<void>;

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

또한보십시오

선적 서류 비치

• 추적 개요: 개념 및 사용 가이드
• 샘플링 전략: 샘플링 구성 세부정보
• 다중 구성 설정: 여러 구성 사용

참조

• 추적 클래스: 핵심 추적 클래스
• 인터페이스: 유형 정의
• 스팬 참조: 스팬 수명주기

수출업체

• MastraStorage수출업체: Mastra Storage에 대한 관측 가능성 이벤트를 지속합니다.
• MastraPlatform수출자: 관측 가능성 이벤트를 Mastra 플랫폼으로 보냅니다.
• 브레인트러스트: Braintrust 통합
• 랭퓨즈: Langfuse 통합
• 랭스미스: LangSmith 통합
• 스팬 필터링: 범위를 선택적으로 제외