Skip to content

Gantt 패널

Gantt는 시작/종료/기간이 있는 row를 시간 막대로 보여줍니다. span, 배치 흐름, 작업 실행 시간처럼 길이와 순서가 중요한 데이터를 볼 때 사용합니다.

Gantt 패널 Data 쿼리 편집 화면

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이 있으면 함께 확인합니다.
Gantt 패널 Fields 설정 화면

Fields에서는 duration tooltip과 숫자 표시 기준을 맞춥니다. 긴 작업이나 실패 상태를 색으로 구분하려면 threshold도 함께 정합니다.

설정 역할
Display Name / No Value Text label이나 end 값이 비어 있을 때 표시할 문구를 정합니다.
Unit / Decimals duration tooltip과 숫자 표시 기준입니다.
Threshold Steps 긴 작업이나 실패 상태를 색상 기준으로 표시할 때 사용합니다.
Value Mappings 상태 code를 사람이 읽는 문구로 바꿉니다.
Gantt 패널 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 높이를 실제 화면 폭에 맞춥니다.