Gantt 패널
Gantt는 시작/종료/기간이 있는 row를 시간 막대로 보여줍니다. span, 배치 흐름, 작업 실행 시간처럼 길이와 순서가 중요한 데이터를 볼 때 사용합니다.
Data에서는 각 row가 하나의 작업, span, 배치 단위가 되도록 query를 구성합니다. start/end 또는 start/duration, label field가 함께 반환되어야 합니다.
| 설정 | 역할 |
|---|---|
| Datasource | trace span, 배치 작업, 이벤트 timeline은 ClickHouse SQL과 잘 맞습니다. |
| Query editor | start, end 또는 start, duration, label field를 반환합니다. |
| Time Filter | 편집 time range와 query 조건을 맞춥니다. |
| Run Query | 시간 단위가 ns/ms/s/unix/ISO 중 무엇인지 확인합니다. |
| JSON | UI에 보이지 않는 schema mapping이 있으면 함께 확인합니다. |
Fields
Section titled “Fields”
Fields에서는 duration tooltip과 숫자 표시 기준을 맞춥니다. 긴 작업이나 실패 상태를 색으로 구분하려면 threshold도 함께 정합니다.
| 설정 | 역할 |
|---|---|
| Display Name / No Value Text | label이나 end 값이 비어 있을 때 표시할 문구를 정합니다. |
| Unit / Decimals | duration tooltip과 숫자 표시 기준입니다. |
| Threshold Steps | 긴 작업이나 실패 상태를 색상 기준으로 표시할 때 사용합니다. |
| Value Mappings | 상태 code를 사람이 읽는 문구로 바꿉니다. |
Visualization
Section titled “Visualization”
Visualization에서는 timestamp 단위와 row grouping, 막대 크기를 정합니다. query column 이름을 바꿨다면 JSON mapping도 함께 확인합니다.
| 설정 | 역할 |
|---|---|
| Time Unit | timestamp 단위를 auto, ns, ms, s, unix ms, unix s, ISO date 중 고릅니다. |
| Group Rows By Label | 같은 label의 row를 묶어 표시합니다. |
| Row Height | 각 row의 높이입니다. 너무 낮으면 label이 읽히지 않습니다. |
| Min Bar Width (px) | 아주 짧은 duration도 최소 몇 px로 보이게 할지 정합니다. |
Data에서 start/end/duration/label field를 확인하고, Fields에서 duration 단위를 맞춘 뒤, Visualization에서 time unit과 row 높이를 실제 화면 폭에 맞춥니다.