본문 바로가기
WIKI 기술 지식 베이스

OTel trace processor

원문 보기 위키 갱신

출처: 문서

본문

OTel trace 프로세서

otel_trace 프로세서는 각 traceId에 대한 루트 스팬 정보를 상태 캐싱함으로써, 들어오는 모든 OpenSearch Data Prepper 스팬 레코드에서 트레이스 그룹 관련 필드를 완성해요.

사용 방법

이 프로세서는 스팬 이벤트에 다음 필드를 추가해요:

  • traceGroup: 루트 스팬 이름
  • endTime: 국제표준화기구(ISO) 8601 형식의 전체 트레이스 종료 시간
  • durationInNanos: 전체 트레이스의 지속 시간(나노초)
  • statusCode: 나노초 단위로 표현된 전체 트레이스의 상태 코드

설정

다음 표에서는 otel_trace 프로세서를 설정할 때 사용할 수 있는 옵션을 설명해요.

옵션 필수 여부 타입 설명
trace_flush_interval 아니요 Integer 루트 스팬이 없는 모든 하위 스팬을 플러시할 시간 간격(초)을 나타내요. 기본값은 180이에요.

메트릭

다음 표는 공통 Abstract processor 메트릭을 설명해요.

메트릭 이름 타입 설명
recordsIn Counter 파이프라인 컴포넌트로 레코드가 유입되는 것을 나타내는 메트릭이에요.
recordsOut Counter 파이프라인 컴포넌트에서 레코드가 배출되는 것을 나타내는 메트릭이에요.
timeElapsed Timer 파이프라인 컴포넌트 실행 중 경과된 시간을 나타내는 메트릭이에요.

otel_trace 프로세서에는 다음과 같은 커스텀 메트릭이 포함되어 있어요:

  • traceGroupCacheCount: 트레이스 그룹 캐시에 있는 트레이스 그룹의 개수예요.
  • spanSetCount: 스팬 집합 컬렉션에 있는 스팬 집합의 개수예요.

더 알아보기 (Learn more)