Explore의 트레이스 통합

Explore는 트레이스(trace)를 지원하는 데이터 소스(Tempo 등)의 트레이스 데이터를 쿼리하고 시각화할 수 있어요. 트레이스 ID로 조회하거나 서비스 검색으로 트레이스를 찾아, 스팬(span) 단위의 타임라인(waterfall) 뷰에서 각 요청의 이동 경로와 소요 시간을 파악할 수 있습니다.

출처: Trace integration

본문

트레이스 쿼리

Explore에서 트레이스를 지원하는 데이터 소스를 선택한 뒤 다음과 같은 방식으로 트레이스를 조회할 수 있습니다.

Trace ID로 검색 – 알려진 트레이스 ID를 입력해 해당 트레이스를 바로 엽니다.
검색(Search) – 서비스, 스팬 이름, 태그, 기간(duration) 등 조건으로 트레이스를 검색합니다.

트레이스 뷰(Waterfall)

트레이스를 열면 트레이스 뷰가 표시되며, 각 스팬이 수평 막대로 나타나는 워터폴(계단식) 차트로 구성됩니다. 지원되는 데이터 소스(Tempo)에서는 추가 트레이스 뷰 유형도 확인할 수 있습니다.

각 스팬 막대는 다음 정보를 보여줍니다.

서비스 – 스팬이 속한 서비스 이름과 스팬 이름
기간 – 해당 스팬의 소요 시간

스팬 상세 정보

트레이스 뷰에서 스팬을 클릭하면 스팬 상세 정보를 볼 수 있습니다.

Span details – 스팬 이름, 서비스, 시작 시간, 기간, 상태 코드 등 기본 정보
태그(Tags) – 스팬에 연결된 키-값 태그 목록
로그(Logs) – 스팬과 연결된 로그 항목
레퍼런스(References) – 부모·자식 스팬 간의 참조 관계

트레이스 뷰 사용 기능

스팬을 펼치거나 접어서 세부 정보를 봅니다.
Search 상자를 이용해 스팬을 이름이나 태그로 필터링합니다.
각 스팬의 기간을 비교해 병목 지점을 파악할 수 있습니다.

트레이스 결과 내려받기

쿼리 검사기(Query inspector)의 Data 탭에서 Download traces를 클릭하면 데이터 소스 유형(Tempo 등)에 따라 트레이스 결과를 Jaeger, Zipkin, OTLP 형식의 JSON 파일로 내려받을 수 있습니다.

Explore의 트레이스 통합