본문으로 건너뛰기

Trend Analysis

Trend Analysis 화면에서는 조회 기간 동안의 인스턴스 지표 추이를 차트로 확인하고, 그 아래 여러 탭에서 실행 중인 쿼리·파트(Part) 이벤트·병합(Merge)·변경(Mutation) 등 항목별 상세 데이터를 시점별로 확인할 수 있습니다.

좌측 메뉴에서 데이터베이스 > ClickHouse > Performance Analysis > Trend Analysis를 선택하세요.

Trend Analysis 전체 화면

화면은 조회 조건, Trend 차트, 하단 탭 목록 세 영역으로 구성됩니다. 위 전체 화면 스크린샷은 Merge 탭에서 진행 중인 병합 작업이 있는 시점(16:00)을 클릭한 상태입니다.

조회 조건 설정하기

Period, Group, Instance로 조회 대상 기간과 인스턴스를 설정합니다. 조건을 변경한 뒤 [Search] 버튼을 클릭해야 새 조건으로 다시 조회됩니다.

Trend 차트에서 지표 추이 확인하기

Trend 영역에는 (OS) CPU Usage (%), Active Process, Logical + Physical I/O, Alarm 지표 차트가 표시됩니다.

차트를 클릭하면 해당 시점이 모든 차트에 공통으로 표시되고, 아래 탭 중 시점 기반 탭(Process, Part Log, Merge, Mutation)의 목록이 그 시점 기준으로 갱신됩니다. 차트를 드래그하면 해당 구간으로 확대(줌)됩니다.

참고

확대한 차트를 원래 기간 범위로 되돌리려면 Trend 영역 우측 상단의 새로고침(⟳) 아이콘을 클릭하세요.

우측 상단 Legend 토글을 켜면 각 차트 아래에 범례가 표시됩니다.

Legend 토글 적용 화면

4x/8x/16x 버튼을 클릭하면 한 화면에 표시할 차트 개수를 늘려 더 많은 지표를 한 번에 볼 수 있습니다. 16x를 선택하면 (OS) Memory Percent, Query, Selected Rows, Log Error, Part Mutation, Inserted Rows, Memory Tracking, TPS, Merged Rows, Merges Mutations Memory Tracking, Slow Query, Mutated Rows까지 16개 지표를 모두 확인할 수 있습니다.

16x 차트 밀도

차트 메뉴로 표시 지표와 방식 바꾸기

차트 우측 상단의 [⋮] 버튼을 클릭하면 Stat Change 팝업이 열립니다. Stat Option 탭에서 표시할 지표를 검색해 선택할 수 있습니다.

Stat Change 팝업 - Stat Option 탭

Chart Option 탭에서는 Display Mode(Line/Bar), Fill Mode, Point Mode를 설정할 수 있습니다.

Stat Change 팝업 - Chart Option 탭

하단 탭의 시점 선택 컨트롤 공통 동작

Process, Part Log, Merge, Mutation 탭 상단에는 ◀◀///▶▶ 버튼과 00부터 55까지의 시각 선택 버튼이 표시됩니다. ◀◀/▶▶ 버튼은 1분 단위로, / 버튼은 5초 단위로 시점을 이동합니다. [+] 버튼을 클릭하면 00~59초까지 1초 단위로 세분화된 버튼으로 확장되며, [-] 버튼으로 다시 접을 수 있습니다.

이 네 탭은 특정 순간의 스냅숏을 보여주므로, 실행 중인 쿼리나 진행 중인 병합·변경 작업이 없는 시점에는 목록이 비어 있는 상태(No data)로 표시되는 경우가 많습니다.

반면 Top SQL, Long Running Query, Alert 탭은 특정 시점이 아니라 조회 조건에서 지정한 전체 기간을 기준으로 집계된 통계를 보여주므로 이 시간 이동 컨트롤이 없습니다.

탭별로 상세 정보 확인하기

하단에는 Process, Top SQL, Long Running Query, Part Log, Merge, Mutation, Alert 7개 탭이 있습니다.

참고

Address 컬럼에는 실제 운영 환경의 클라이언트 접속 정보가 표시될 수 있으므로, 화면을 공유하거나 캡처할 때는 노출에 주의하세요.

Process에서 실행 중인 쿼리 확인하기

Process 탭에는 선택한 시점에 실행 중이던 쿼리가 Hostname, Current Database, User, Address, Port, Elapsed Time (sec), Query ID, Query, Memory Usage, Peak Memory Usage, Thread IDs, Is Initial Query, Is Cancelled, Read Rows, Read Bytes 등의 컬럼으로 표시됩니다. 컬럼 구성과 Query 클릭 동작은 아래 Long Running Query 탭과 동일합니다. 위 전체 화면 스크린샷의 하단 목록이 이 Process 탭입니다.

Top SQL에서 SQL 순위 확인하기

Top SQL 탭에는 조회 기간 동안의 쿼리 실행 통계 순위가 Rank, Hostname, Current Database, User, Normalized Query Hash, Query, Query Duration (sec), Query Count, CPU Time, Memory Usage, Read Rows, Read Bytes 컬럼으로 표시됩니다. 우측 상단 Order By 드롭다운(Query Duration (sec)/Memory Usage/CPU Time)과 Sum/Avg 토글은 Search SQL의 조회 조건과 동일하게 동작합니다.

Top SQL 탭

Normalized Query Hash 값을 클릭하면 화면 우측에 해당 쿼리의 상세 패널이 열립니다. 패널 구성(Full Text/Trend/History/Plan 탭)은 Search SQL의 SQL 상세 패널과 동일합니다. Query 값을 클릭하면 SQL Full Text 팝업이 열려 전체 구문을 확인할 수 있습니다.

Long Running Query에서 오래 실행된 쿼리 확인하기

Long Running Query 탭에는 조회 기간 동안 오래 실행된 쿼리가 Elapsed Time (sec) 내림차순으로 Rank, Hostname, Current Database, User, Address, Port, Elapsed Time (sec), Query ID, Query, Memory Usage, Peak Memory Usage, Thread IDs 등의 컬럼에 표시됩니다.

Long Running Query 탭

Query 값을 클릭하면 화면 우측에 해당 쿼리의 상세 패널이 열립니다. 패널은 Normalized Query Hash 기준으로 열리며, 구성(Full Text/Trend/History/Plan 탭)은 Search SQL의 SQL 상세 패널과 동일합니다.

참고

Process, Long Running Query 탭의 쿼리는 파라미터가 실제 값으로 채워진 상태로 실행되므로, Top SQL·Search SQL의 정규화된 쿼리와 달리 Plan 탭에서 오류 없이 실제 실행 계획을 확인할 수 있는 경우가 많습니다.

목록 우측 상단의 [⋮] 버튼을 클릭하면 Reset user data, Export to Excel, Column List 메뉴가 열립니다. 이 메뉴는 다른 탭의 목록에도 동일하게 제공됩니다.

Part Log에서 파트 이벤트 이력 확인하기

Part Log 탭에는 선택한 시점의 파트 생성·병합 이벤트가 Hostname, Database, Table, Table UUID, Event Type, Merge Reason, Merge Algorithm, Duration (sec), Event Time Microseconds, Part Name, Partition ID, Partition, Part Type, Disk Name, Path on Disk 컬럼으로 표시됩니다. 컬럼 구성은 Instance Detail의 Part Log 탭과 동일하며, 이 탭은 조회 조건에서 선택한 시점 하나만 보여준다는 점이 다릅니다.

Part Log 탭

Merge에서 진행 중인 병합 작업 확인하기

Merge 탭에는 선택한 시점에 진행 중이던 병합 작업이 Hostname, Database, Table, Source Part Names, Result Part Name, Elapsed Time (sec), Progress (%), Num Parts, Total Size Bytes Compressed, Total Size Bytes Uncompressed, Total Size Marks, Bytes Read Uncompressed, Rows Read 등의 컬럼으로 표시됩니다. Progress (%) 컬럼은 진행률을 막대로 함께 보여줍니다.

Merge 탭

Mutation에서 변경 작업 이력 확인하기

Mutation 탭에는 선택한 시점의 ALTER TABLE ... UPDATE/DELETE 같은 변경(Mutation) 작업이 Hostname, Database, Table, Mutation ID, Command, Create Time, Block Numbers.Partition ID, Block Numbers.Number, Parts To Do Names, Parts To Do, Is Done, Is Killed, Latest Failed Part, Latest Fail Time 컬럼으로 표시됩니다. 컬럼 구성은 Instance Detail의 Mutation 탭과 동일하며, 이 탭은 조회 조건에서 선택한 시점 하나만 보여준다는 점이 다릅니다.

Mutation 탭

Alert에서 알림 이력 확인하기

Alert 탭에는 조회 기간 동안 발생한 알림이 Time, Alert Type, Alert Name, Level, Value로 표시됩니다. Level 컬럼에는 Normal(정상), Warning(경고), Critical(심각) 배지가 표시됩니다.

Alert 탭

목록 상단의 필터 입력란에 텍스트를 입력하면 컬럼 값 기준으로 각 탭의 목록을 빠르게 필터링할 수 있습니다.