Trace 패널

Trace 패널은 trace 목록과 요약을 보여줍니다. 일반 PromQL 패널보다 ClickHouse trace 데이터와 더 밀접합니다.

Data

Data에서는 trace 목록을 구성할 column을 안정적으로 반환해야 합니다. trace_id, service, operation, duration, status, timestamp 계열 column이 빠지면 Visualization에서 목록을 제대로 구성하기 어렵습니다.

설정	역할
Datasource	보통 ClickHouse (SQL)을 사용합니다.
Query editor	trace id, service, operation, duration, status, timestamp column을 반환합니다.
Time Filter	$__fromTime, $__toTime 매크로로 편집 화면 time range와 맞춥니다.
Trace Query / Group By	trace 목록 또는 service별 집계 template을 빠르게 넣을 때 사용합니다.
Run Query	column 이름과 duration 단위가 Trace 설정과 맞는지 확인합니다.

Fields

Fields에서는 trace duration, status code, 빈 값 표시 기준을 정합니다. 목록 column이 많아도 값의 단위와 상태 문구는 여기서 일관되게 맞춥니다.

설정	역할
Display Name / No Value Text	column 이름과 비어 있는 status, operation 문구를 정합니다.
Unit / Decimals	trace duration이 ns/us/ms 중 무엇인지 query와 맞춥니다.
Threshold Steps	duration이나 error count를 상태 색상으로 해석할 때 사용합니다.
Value Mappings	status code를 Error, OK 같은 문구로 바꿉니다.
Color Scheme	status나 duration 색상이 운영 의미와 맞는지 확인합니다.

Visualization

Visualization에서는 summary card와 trace list column을 정합니다. 장애 triage 화면에서는 status, service, operation, duration처럼 판단 근거가 되는 column을 앞쪽에 둡니다.

설정	역할
Show summary cards	Total, Errors, Success 같은 summary card 표시 여부입니다.
Trace Columns	trace list column 표시 여부와 순서를 정합니다.
Drag to reorder	visible column을 drag해서 순서를 바꿉니다.
Checkbox	column을 숨기거나 다시 표시합니다. 최소 하나의 visible column은 유지합니다.

확인 순서

Data에서 trace 목록 column을 확인하고, Fields에서 duration 단위와 status 문구를 맞춘 뒤, Visualization에서 summary card와 column 순서를 줄여 읽기 쉽게 만듭니다.