용어집
용어집 (Glossary)
트레이스에 대해 논의할 때 자주 사용되는 용어들을 정리한 용어집이에요. 각 용어의 정의를 통해 트레이싱 개념을 이해할 수 있어요.
출처: 문서
본문
다음 용어는 트레이스에 대해 논의할 때 자주 사용돼요.
Active series: 새 데이터 포인트나 샘플을 받는 시계열.
Cardinality: 주어진 메트릭 시리즈나 로그 스트림에 대한 라벨·라벨 값 같은 키/값 쌍의 총 조합과 그들이 생성하는 고유 조합의 수.
Child span: 부모 스팬 안에 중첩된 스팬. 각 자식 스팬은 부모가 나타내는 더 넓은 작업 내의 하위 작업 또는 다운스트림 호출을 나타내요. 자식 스팬은 그 자체로 다른 자식 스팬의 부모가 될 수 있어요.
Data source: 데이터베이스, 플랫 파일, 또는 기기의 실시간 참조·측정 같은 데이터의 기본 저장소. 데이터를 제공하는 파일, 데이터베이스 또는 서비스. 예를 들어 트레이스 데이터는 Tempo 데이터 소스를 구성·활성화해 Grafana로 가져와요.
Event attribute: 스팬의 기간 중 고유한 시점을 나타내는 스팬 이벤트에 첨부된 키/값 쌍. 자세한 내용은 OpenTelemetry 문서의 Span events를 참고해요.
Exemplar: 메트릭으로 집계된 관찰 중 하나의 상세한 예시 역할을 하는 모든 데이터. exemplar는 관찰된 값과 선택적 타임스탬프, 일반적으로 트레이스를 참조하는 데 사용되는 임의 트레이스 ID를 포함해요.
Intrinsics: 스팬과 트레이스의 정체성과 수명 주기에 근본적인 코어 내장 필드. name, duration, status, kind 같은 필드가 포함돼요. 이 필드는 OpenTelemetry 사양에 의해 정의되며 항상 존재해요.
Link attribute: 스팬 링크에 첨부된 키/값 쌍. 스팬 링크는 한 스팬을 하나 이상의 인과적으로 관련된 스팬과 연결해요. 자세한 내용은 OpenTelemetry 문서의 Span Links를 참고해요.
Log: 보통 텍스트 기반의 연대순 이벤트로, 문제 진단을 가능하게 해요. 로그는 사용자 상호작용 중 모든 이벤트의 상세 기록(예: 이벤트가 언제 발생했는지, 시스템을 누가 사용했는지, 상태 메시지 등) 같은 정보 컨텍스트를 제공할 수 있어요.
Metric: 운영자가 시스템의 상태를 이해하는 데 도움이 되는 숫자. 예를 들어 활성 사용자 수, 오류 수, 평균 응답 시간 등이에요.
Resource attribute: 클러스터 이름, 네임스페이스, Pod 또는 컨테이너 이름 같은 스팬을 생성하는 엔티티에 대한 정보를 나타내는 키/값 쌍.
Root span: 트레이스의 첫 번째 스팬으로, 초기 요청 또는 작업을 나타내요. 루트 스팬은 부모 스팬이 없고 스팬 트리의 꼭대기 역할을 해요.
Semantic attribute: OpenTelemetry 사양에 의해 정의된, 언어·프레임워크·런타임 전반에 공유되는 속성의 표준화된 명명 체계. 자세한 내용은 OpenTelemetry 문서의 Trace Semantic Conventions를 참고해요.
Span: 트레이스 내에서 수행된 작업의 단위.
Span attribute: 추적하는 작업에 대한 정보로 스팬을 주석 처리하는 메타데이터를 포함한 키/값 쌍. 예를 들어 "장바구니에 추가" 작업을 추적하는 스팬에는 span attributes로 사용자 ID, 항목 ID, 장바구니 ID가 포함될 수 있어요.
Spanset: TraceQL 쿼리에서 반환된 각 개별 트레이스의 스팬 그룹.
Trace: 트레이스는 요청 또는 작업이 분산 시스템(특히 컨테이너화된 애플리케이션이나 마이크로서비스 아키텍처)의 모든 노드를 통과하는 전체 여정을 나타내요. 트레이스는 스팬으로 구성돼요. 자세한 내용은 What is Distributed Tracing?을 참고해요.