Instance Detail
Instance 화면의 Instance List에서 ClickHouse 인스턴스 이름을 클릭하면 화면 우측에 열리는 상세 패널에서는, 다른 DB 엔진과 달리 ClickHouse 전용 탭 구성으로 에이전트 정보·실시간 지표·활성 프로세스·쿼리 로그·파트(Part) 정보·Mutation·복제 상태·서버 로그·알림·파라미터·호스트 프로세스를 한 화면에서 확인할 수 있습니다.
좌측 메뉴에서 데이터베이스 > Instance를 선택한 뒤, Instance List에서 ClickHouse 인스턴스 이름을 클릭하세요.
패널은 Information, Metric, Active Process, Query Log, Part Activity, Part Log, Merge Event, Mutation, Replication, Text Log, Alert, Parameter, Host Process List 13개 탭으로 구성됩니다. 탭이 많아 한 화면에 다 표시되지 않으면 탭 목록 좌우의 [<] / [>] 화살표를 클릭해 나머지 탭으로 이동할 수 있습니다.
개별 ClickHouse 인스턴스는 Instance List의 Monitoring 컬럼에 Single View 같은 버튼이 제공되지 않습니다. Multi View는 Instance Group으로 묶인 클러스터 행에만 제공되며, 개별 인스턴스의 상세 정보는 이 문서에서 다루는 상세 패널을 통해 확인합니다.
Information에서 에이전트·디스크·머신 정보 확인하기
Information 탭은 Agent, Disk, Machine 세 영역으로 구성됩니다.
Agent에는 Instance Name, Status, Instance Group Name, Agent Version, DB Engine, DB Version, Last Boot Time, Uptime이 표시됩니다.
- Instance Name 옆 [Multi >] 버튼을 클릭하면 이 인스턴스가 속한 Instance Group 기준의 [ClickHouse] 대시보드 화면으로 이동합니다.
- 그 옆 [Detail >] 버튼은 비활성화 상태로 표시됩니다.
- 톱니바퀴 아이콘을 클릭하면 Go to Dashboard 팝업이 열려, [Multi >] 버튼의 이름을 바꾸거나(Change button name) 연결할 대시보드를 목록에서 선택할 수 있고, [+ Add URL] 버튼으로 외부 URL을 직접 추가할 수도 있습니다.
Disk에는 인스턴스의 디스크별 Disk Name, Path, Disk Usage (%), Free, Total이 표시되고, Machine에는 Host Name, Host IP, OS, Kernel Version이 표시됩니다. 두 영역 모두 별도의 클릭 동작은 없으며, Disk 목록 우측 상단의 [⋮] 버튼을 클릭하면 Reset user data, Export to Excel, Column List 메뉴가 열립니다. 이 메뉴는 이 문서의 다른 목록에도 동일하게 제공됩니다.
Metric에서 실시간 지표 추이 확인하기
Metric 탭에서는 Memory Tracking, Query, Merge, Part Mutation 등 여러 지표를 실시간 차트로 확인할 수 있습니다.
우측 상단의 기간 표시를 클릭하면 조회 주기를 바꿀 수 있고, 옆의 [◀◀]/[일시정지]/[▶▶] 버튼으로 이전 구간 이동, 실시간 갱신 일시정지, 다음 구간 이동을 할 수 있습니다. 차트 위를 드래그하면 그 시점의 값이 툴팁으로 표시됩니다.
각 차트 우측 상단의 [⋮] 버튼을 클릭하면 Chart Setting 팝업이 열려, Chart Name을 바꾸거나 Display Mode, Legend, Stack Mode, Fill Mode 같은 표시 방식과 Chart Data에서 표시할 지표(Stat Name), 집계 방식(Data Type), Alias를 설정할 수 있습니다. [Reset] 버튼을 클릭하면 차트를 기본 설정으로 되돌립니다.
Active Process에서 실행 중인 쿼리 확인하기
Active Process List에서는 현재 실행 중인 쿼리를 Current Database, User, Address, Port, Elapsed Time (sec), Normalized Query Hash, Query ID 등의 컬럼으로 확인할 수 있습니다.
행 왼쪽 체크박스를 하나 이상 선택하면 우측 상단의 [Multi Kill] 버튼이 활성화되며, 클릭하면 선택한 프로세스를 강제 종료합니다. 실행 중인 쿼리를 실제로 중단시키는 동작이므로 신중하게 사용하세요.
[Get] 버튼을 클릭하면 목록을 새로고침합니다.
Normalized Query Hash 값을 클릭하면 패널 전체가 해당 쿼리의 SQL 상세 뷰로 전환됩니다.
SQL 상세 뷰에는 Date, Normalized Query Hash, User Name이 표시되고, [Search SQL >] 버튼을 클릭하면 SQL 분석 화면으로 이동할 수 있습니다. Full Text, Trend, History, Plan 탭으로 SQL 전체 구문, 실행 추이, 실행 이력, 실행 계획을 확인할 수 있으며, 패널 좌측 상단의 [◀] 아이콘을 클릭하면 다시 Active Process List로 돌아갈 수 있습니다.
Query Log에서 상위 쿼리 확인하기
Top Query Log에서는 Query Option Setting에서 지정한 건수(Row Limit, 1~1000)만큼 상위 쿼리를 확인할 수 있습니다. [Get] 버튼을 클릭하면 새 설정으로 다시 조회합니다.
우측 상단의 Sum/Avg 토글로 값을 합계와 평균 중 어느 기준으로 볼지 전환할 수 있습니다. Avg를 선택하면 토글과 함께 집계 컬럼이 붉은색으로 바뀝니다.
Query 컬럼을 클릭하면 SQL Full Text 팝업이 열려 전체 SQL 구문을 확인할 수 있고, [Format SQL] 버튼으로 보기 좋게 정렬할 수 있습니다.
Normalized Query Hash 값을 클릭하면 Active Process와 동일하게 SQL 상세 뷰가 열립니다.
Part Activity에서 테이블별 파트 사용량 확인하기
Table-wise Part Usage에서는 테이블별 Database, Table, Engine, Active Parts, Inactive Parts, Active Part on Disk 등을 확인할 수 있습니다. 특별한 클릭 동작 없이 조회 전용 목록이며, 목록 상단의 필터 입력란에 텍스트를 입력하면 컬럼 값 기준으로 빠르게 필터링할 수 있습니다.
Part Log에서 파트 이벤트 이력 확인하기
Part Log List에서는 Query Option Setting의 Row Limit만큼 파트 생성·병합 이벤트를 Database, Table, Table UUID, Event Type, Merge Reason, Merge Algorithm, Duration (sec) 등의 컬럼으로 확인할 수 있습니다.
Merge Event에서 진행 중인 병합 작업 확인하기
Merge Event List는 실시간(Live)으로 갱신되며, 우측 상단 [일시정지] 버튼으로 갱신을 멈출 수 있습니다. Sum/Avg 토글은 Query Log와 동일하게 동작합니다.
Group by 체크박스를 켜면 옆의 Database/Table 버튼으로 그룹화 기준을 선택할 수 있고, 선택한 기준으로 Elapsed Time (sec), Total Size Bytes 등 숫자 컬럼이 집계되어 헤더가 초록색으로 바뀝니다.
Mutation에서 변경 작업 이력 확인하기
Mutation List는 실시간으로 갱신되며, ALTER TABLE ... UPDATE/DELETE 같은 변경(Mutation) 작업을 Hostname, Database, Table, Mutation ID, Command, Create Time 등의 컬럼으로 확인할 수 있습니다.
Command 값을 클릭하면 Command 팝업이 열려 전체 명령 구문을 확인하고 복사 아이콘으로 클립보드에 복사할 수 있습니다.
Replication에서 복제 상태 확인하기
Replica Status Information은 실시간으로 갱신되며, 복제(Replicated) 테이블의 Database, Table, Engine, Is Leader, Can Become Leader, Zookeeper Name, Zookeeper Path, Replica Name, Replica Path 등을 확인할 수 있습니다. 우측 상단 View Abnormal Only 토글을 켜면 비정상 상태인 복제본만 표시됩니다.
Text Log에서 서버 로그 확인하기
Text Log List의 Query Option Setting에서는 Search current log(현재 시점 기준 Line 수, 1~1000)와 Select Time(달력에서 특정 시점 선택) 중 조회 방식을 라디오 버튼으로 선택할 수 있습니다. [Scan More] 버튼을 클릭하면 더 많은 로그를 추가로 불러옵니다.
Message 값을 클릭하면 Message 팝업이 열려 로그 메시지 전체 내용을 확인하고 복사할 수 있습니다.
Alert에서 알림 규칙과 현재 상태 확인하기
Rule List에서는 이 인스턴스에 적용된 알림 규칙을 Rule Name, Alert Stat Name, Target, Alert Detail, Last Triggered, Rule Type 등으로 확인할 수 있습니다. Show only Triggered Alert 체크박스를 켜면 알림이 발생한 규칙만 표시되고, 우측 [List]/[Bar] 버튼으로 표 형태와 임계값 막대 형태 중 보기 방식을 전환할 수 있습니다.
Rule Name을 클릭하면 패널 전체가 해당 규칙의 상세 뷰로 전환되며, Information(규칙 조건), Current(현재 값), History(발생 이력 차트와 목록) 탭으로 구성됩니다.
DB CPU Usage, DB Memory Usage처럼 Rule Type이 Metric인 규칙은 특정 DB 엔진 전용이 아니라 전체 인스턴스 공통으로 등록된 규칙일 수 있습니다. Target에 표시된 인스턴스 목록으로 적용 범위를 확인하세요.
Parameter에서 파라미터 값과 변경 이력 확인하기
Parameter List에서는 ClickHouse 설정 파라미터를 Parameter Name, Current Value 컬럼으로 확인할 수 있습니다.
Parameter Name을 클릭하면 패널 전체가 해당 파라미터의 상세 뷰로 전환됩니다. Information에는 Description, Default, Min, Max, Type, Readonly, Alias for, Is Obsolete가 표시되고, 아래 Parameter List에서 기간별 Date, Current Value, Prev Value, Status로 값 변경 이력을 확인할 수 있습니다.
Host Process List에서 호스트 프로세스 확인하기
Process List는 실시간으로 갱신되며, 인스턴스가 실행 중인 호스트의 OS 프로세스를 PID, PPID, Process Name, Args, User Name, Start Time, CPU (%) 등의 컬럼으로 확인할 수 있습니다.
Host Process List는 인스턴스 등록 시 OS Resource에 host-agent가 설정되어 있어야 데이터가 표시됩니다. host-agent가 설정되지 않은 인스턴스는 목록이 비어 있는 상태(No data)로 표시되며, 이는 모든 DB 엔진의 Instance Detail에 공통으로 적용됩니다.
PID 값을 클릭하면 패널 전체가 해당 프로세스의 상세 뷰로 전환됩니다. Information 탭에는 PID, PPID, Process Name, Args, User Name, Start Time, Cores와 함께 Max address space 등 리소스 제한(Limit) 표가 표시되고, 아래 GPU Resource Map에서 이 프로세스와 호스트의 관계를 노드 그래프로 확인할 수 있습니다. 그래프 좌측 하단 [+]/[-] 버튼으로 확대·축소, [⛶] 버튼으로 전체 화면 보기, [🔒] 버튼으로 노드 위치 잠금을 설정할 수 있습니다.
