> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> 쿼리 디버깅과 성능 최적화를 더 쉽게 할 수 있도록 system.query_log 데이터를 시각화합니다
# 쿼리 인사이트
export const Image = ({img, alt, size}) => {
return
;
};
**쿼리 인사이트** 기능은 시각화와 테이블을 통해 ClickHouse의 기본 제공 쿼리 로그를 더 쉽게 활용할 수 있도록 합니다. ClickHouse의 `system.query_log` 테이블(table)은 쿼리 최적화(query optimization), 디버깅(debugging), 그리고 클러스터(cluster) 전반의 상태와 성능을 모니터링하는 데 중요한 정보원입니다.
## 쿼리 개요
서비스를 선택하면 왼쪽 사이드바의 **모니터링** 메뉴가 확장되며, 새 **쿼리 인사이트** 하위 항목이 표시됩니다. 이 옵션을 클릭하면 쿼리 인사이트 페이지가 열립니다:
## 상위 메트릭
상단의 통계 상자는 선택한 기간의 기본적인 상위 쿼리 메트릭을 나타냅니다. 그 아래에는 선택한 시간 구간 동안 쿼리 종류(select, insert, 기타)별 쿼리 볼륨, 지연 시간, 오류율을 보여주는 3개의 시계열 차트가 표시됩니다. 지연 시간 차트는 p50, p90, p99 지연 시간을 표시하도록 추가로 조정할 수 있습니다:
## 최근 쿼리
상위 메트릭 아래에는 선택한 시간 범위 동안의 쿼리 로그 항목(정규화된 쿼리 해시와 사용자별로 그룹화됨)을 표시하는 테이블이 있습니다:
최근 쿼리는 사용 가능한 모든 필드를 기준으로 필터링하고 정렬할 수 있습니다. 또한 이 테이블은 tables, p90, p99 지연 시간과 같은 추가 필드를 표시하거나 숨기도록 설정할 수도 있습니다.
## 쿼리 드릴다운
최근 쿼리 테이블에서 쿼리를 선택하면, 선택한 쿼리에 대한 메트릭과 정보가 담긴 플라이아웃이 열립니다:
플라이아웃에서 확인할 수 있듯이, 이 쿼리는 지난 24시간 동안 3000회 이상 실행되었습니다. **쿼리 정보** 탭의 모든 메트릭은 집계 메트릭이지만, **쿼리 이력** 탭을 선택하면 개별 실행의 메트릭도 확인할 수 있습니다:
이 패널에서는 각 쿼리 실행의 `Settings` 및 `Profile Events` 항목을 펼쳐 추가 정보를 확인할 수 있습니다.