본문으로 건너뛰기

Top N Analysis

Top N Analysis 화면에서는 조회 조건에 따라 실행 시간 등 지표가 높은 쿼리 순위를 확인할 수 있습니다. Group by 옵션으로 User·Database 기준 요약을 추가로 확인할 수도 있습니다.

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

Top N Analysis 전체 화면

화면은 조회 조건, Value 차트, Top SQL 목록 세 영역으로 구성됩니다. Group byUser 또는 Database로 바꾸면 Top SQL 목록 위에 그 기준의 요약 목록이 추가로 표시됩니다.

조회 조건 설정하기

Period, Group, Instance로 조회 대상 기간과 인스턴스를 좁힐 수 있습니다.

Group by로 요약 기준 추가하기

옵션설명
Norm. Query Hash요약 없이 쿼리 단위로만 Top SQL 목록을 보여줍니다. (기본값)
UserTop SQL 목록 위에 사용자별 요약인 Top User 목록을 추가로 보여줍니다.
DatabaseTop SQL 목록 위에 데이터베이스별 요약인 Top Database 목록을 추가로 보여줍니다.

Group by 드롭다운

User로 그룹을 바꾼 뒤 [Search]를 클릭하면 다음과 같이 Top User 목록이 추가됩니다.

Group by를 User로 바꾼 화면

Top User 목록에는 User NameQuery Count, Query Duration (sec), CPU Time, Memory Usage, Read Bytes, Written Bytes, Result Bytes와 함께, 전체 대비 비중을 막대로 보여주는 Query Count (%), Query Duration (%), CPU Time (%), Memory Usage (%), Read Bytes (%) 컬럼이 표시됩니다.

참고

Top User/Top Database 목록의 행을 클릭해도 아래 Top SQL 목록이 필터링되지는 않습니다. 이 목록은 대상별 비중을 확인하는 용도로만 사용하세요.

Order By로 정렬 기준 바꾸기

옵션
Query Duration (sec)
CPU Time
Memory Usage
Read Bytes
Query Count
Written Bytes
Result Bytes
Read Rows
Written Rows
Result Rows

Order By 드롭다운

Top 값 지정하고 조회하기

Top 입력란에 숫자를 입력해 목록에 표시할 순위 개수를 지정한 뒤 [Search] 버튼을 클릭하면 위 조건을 반영해 화면 전체를 다시 조회합니다.

Value 차트에서 추이 확인하기

Value 차트는 조회 기간 동안 Order By 지표의 전체 합계(Total Query Duration 등)를 선으로 보여주며, Top SQL(또는 Top User/Top Database) 목록에서 행을 클릭하면 그 대상의 추이가 차트에 함께 추가됩니다.

우측 상단 [Retry] 버튼을 클릭하면 차트를 최초 조회 조건 기준으로 다시 그립니다. 버튼 옆 물음표 아이콘에 마우스를 올리면 이 동작에 대한 설명을 툴팁으로 확인할 수 있습니다.

Top SQL 목록에서 쿼리별 상세 확인하기

Top SQL 목록에는 순위별 쿼리와 Host Name, Current Database, User, Normalized Query Hash, Query Count, Query Duration (sec), CPU Time, Memory Usage, Read Bytes, Written Bytes, Result Bytes 등 실행 통계가 표시됩니다. 목록 상단의 필터 입력란에 텍스트를 입력하면 컬럼 값 기준으로 빠르게 필터링할 수 있고, 우측 상단 Sum/Avg 토글로 값을 합계와 평균 중 어느 기준으로 볼지 전환할 수 있습니다.

Normalized Query Hash 클릭으로 쿼리 상세 정보 확인하기

목록에서 Normalized Query Hash 값을 클릭하면 화면 우측에 해당 쿼리의 상세 패널이 열립니다. 패널 구성과 탭(Full Text/Trend/History/Plan)은 Instance Detail의 SQL 상세 뷰와 동일합니다.

SQL Detail 패널

참고

Plan 탭은 쿼리에 ?로 표시된 바인드 파라미터가 남아 있으면 Illegal type String expression, must be numeric type 같은 오류가 표시될 수 있습니다. 파라미터가 실제 값으로 채워지지 않은 정규화된 쿼리이기 때문입니다.

Query 클릭으로 쿼리 전문 확인하기

목록에서 Query 값을 클릭하면 SQL Full Text 팝업이 열려 해당 쿼리의 전체 구문을 확인할 수 있습니다. [Format SQL] 버튼을 클릭하면 구문을 정렬해서 보여줍니다.

SQL Full Text 팝업

그리드 메뉴로 목록 관리하기

목록 우측 상단의 [⋮] 버튼을 클릭하면 Reset user data, Export to Excel, Column List 메뉴가 열립니다.

그리드 ⋮ 메뉴

  • Reset user data: 사용자가 변경한 컬럼 순서·너비 등 설정을 초기화합니다.
  • Export to Excel: 현재 목록을 엑셀 파일로 내보냅니다.
  • Column List: 목록에 표시할 컬럼을 체크박스로 선택하는 팝업을 엽니다.

이 메뉴는 Top User/Top Database 목록에도 동일하게 제공됩니다.