Exemplar 소개

Exemplar 소개 (Introduction to exemplars)

Exemplar은 주어진 시간 간격에서 측정된 것의 대표가 되는 특정 트레이스예요. 메트릭이 시스템의 집계된 뷰를 주는 데 뛰어난 반면, 트레이스는 단일 요청의 세밀한 뷰를 주는데, exemplar는 둘을 연결하는 방법이에요. 예를 들어 웹사이트 트래픽이 급증하고 80% 이상의 사용자는 2초 안에 접속하지만 일부 사용자는 비정상적으로 높은 응답 시간을 겪는 상황에서, 지연 시간의 원인을 찾으려면 빠른 응답과 느린 응답의 트레이스를 비교해야 해요. Exemplar은 시간 간격 내에서 높은 지연 시간을 보이는 쿼리 트레이스를 정확히 짚어, 데이터 분포 안의 문제를 격리하는 데 도움을 줘요.

출처: 문서

본문

몇 개의 exemplar 트레이스로 지연 문제를 국소화한 뒤, 추가 시스템 기반 정보나 위치 속성과 결합해 근본 원인 분석을 더 빨리 수행하고 성능 문제를 신속히 해결할 수 있어요.

Exemplar 지원은 Prometheus 데이터 소스에서만 사용 가능해요. 기능을 활성화하면 기본적으로 exemplar 데이터를 사용할 수 있어요. exemplar 구성과 활성화 방법은 Prometheus 구성 옵션의 Exemplars 섹션을 참고하세요.

Grafana는 Explore 뷰와 대시보드에서 메트릭 옆에 exemplar를 표시해요. 각 exemplar는 강조된 별로 표시돼요. exemplar에 마우스를 올리면 키-값 쌍의 조합인 고유 트레이스 ID를 볼 수 있고, 더 조사하려면 traceID 속성 옆의 파란 버튼을 클릭해요.

Exemplar 데이터 보기

Prometheus 데이터 소스에서 exemplar 지원이 활성화되면 Explore 뷰나 Loki 로그 세부 정보에서 exemplar 데이터를 볼 수 있어요.

Explore에서

Explore는 exemplar 트레이스를 메트릭 데이터 옆의 강조된 별로 시각화해요. exemplar 트레이스 세부 정보를 보려면:

  • exemplar(강조된 별)에 커서를 올려요. 사용 중인 트레이스 데이터 소스에 따라 Query with <DATA SOURCE NAME> 라벨의 파란 버튼이 보일 수 있어요(예제에서는 Tempo).
  • traceID 속성 옆의 파란 버튼을 클릭해요. 트레이스 내 스팬을 포함한 트레이스 세부 정보가 오른쪽의 별도 패널에 표시돼요.

트레이스·스팬 세부 정보를 드릴다운·분석하는 방법은 Analyze trace and span details 섹션을 참고하세요.

로그에서

Explore의 Loki 로그에서도 exemplar 트레이스 세부 정보를 볼 수 있어요. Loki용 Derived fields 링크 안에서 정규식을 사용해 traceID 정보를 추출해요. 그러면 Loki 로그를 펼칠 때 Detected fields 섹션 아래 traceID 속성을 볼 수 있어요. 로그 메시지의 일부를 내부·외부 링크로 추출하는 방법은 Loki의 derived fields 사용을 참고하세요. exemplar 트레이스 세부 정보를 보려면:

  • 로그 줄을 펼치고 Fields 섹션으로 스크롤.
  • 백엔드 트레이스 데이터 소스에 따라 <DATA SOURCE NAME> 라벨의 파란 버튼이 보일 수 있음.
  • traceID 속성 옆의 파란 버튼 클릭. 보통 백엔드 데이터 소스 이름을 가짐.
  • 트레이스 내 스팬을 포함한 트레이스 세부 정보가 오른쪽 패널에 표시.

트레이스·스팬 분석

이 패널은 트레이스 세부 정보를 여러 세그먼트로 보여줘요.

  • 상단 세그먼트는 쿼리 결과가 특정 트레이스에 해당함을 나타내는 트레이스 ID를 표시. Add query 버튼으로 결과에 트레이스를 더 추가할 수 있어요.
  • 다음 세그먼트는 특정 트레이스의 전체 스팬을 좁은 띠로 표시. 클라이언트에서 데이터베이스 쿼리까지 모든 레벨이 표시되어, HTTP 요청이 처리된 모든 계층에 걸친 시간 분포의 조감도를 제공해요. 띠 뷰 안을 클릭하면 스팬 내 더 작은 시간 세그먼트의 확대 뷰를 표시해요. 확대 뷰는 패널 하단 세그먼트에 나타나며, 트레이스의 여러 레벨을 확장·축소해 관심 있는 특정 스팬으로 드릴다운할 수 있어요. 특정 스팬 계층을 확장하려면 왼쪽 아이콘을 클릭하고, 같은 버튼으로 확장된 스팬을 축소할 수 있어요.
  • 스팬 세부 정보를 보려면 스팬 자체를 클릭해요. 스팬과 관련된 추가 메타데이터가 표시되고, 메타데이터 띠를 클릭하면 더 자세한 내용을 볼 수 있어요.

더 알아보기 (Learn more)