> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> 하드웨어 리소스 사용률과 ClickHouse 서버 메트릭을 모니터링할 수 있습니다.

# 모니터링

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<Note>
  이 가이드에서 설명하는 모니터링 데이터는 ClickHouse Cloud에서 확인할 수 있습니다. 아래에서 설명하는 기본 제공 대시보드에 표시될 뿐만 아니라, 기본 및 고급 성능 메트릭도 기본 서비스 콘솔에서 직접 확인할 수 있습니다.
</Note>

모니터링할 수 있는 항목은 다음과 같습니다.

* 하드웨어 리소스 사용률
* ClickHouse 서버 메트릭

<div id="built-in-advanced-observability-dashboard">
  ## 내장 고급 관측성 대시보드
</div>

<Image img="https://mintcdn.com/private-7c7dfe99/nYSl14_LxtbSRLxz/images/cloud/manage/monitoring/native_advanced_dashboard.webp?fit=max&auto=format&n=nYSl14_LxtbSRLxz&q=85&s=38edf643d858dbc9d2c666025a1b104d" alt="네이티브 고급 관측성 대시보드" size="md" width="1600" height="870" data-path="images/cloud/manage/monitoring/native_advanced_dashboard.webp" />

ClickHouse에는 `$HOST:$PORT/dashboard`에서 접속할 수 있는 내장 고급 관측성 대시보드 기능이 포함되어 있으며(사용자 및 비밀번호 필요), 다음 메트릭을 표시합니다:

* 초당 쿼리 수
* CPU 사용량(코어)
* 실행 중인 쿼리
* 실행 중인 머지
* 초당 선택된 바이트 수
* IO 대기
* CPU 대기
* OS CPU 사용량(사용자 공간)
* OS CPU 사용량(커널)
* 디스크 읽기
* 파일 시스템 읽기
* 메모리(추적됨)
* 초당 삽입된 행 수
* 전체 MergeTree 파트 수
* 파티션당 최대 파트 수

<div id="resource-utilization">
  ## 리소스 사용 현황
</div>

ClickHouse는 다음과 같은 하드웨어 리소스의 상태도 자체적으로 모니터링합니다.

* 프로세서의 부하 및 온도
* 스토리지 시스템, RAM, 네트워크의 사용 현황

이 데이터는 `system.asynchronous_metric_log` 테이블에 수집됩니다.

<div id="clickhouse-server-metrics">
  ## ClickHouse 서버 메트릭
</div>

ClickHouse 서버에는 자체 상태를 모니터링하기 위한 내장 기능이 있습니다.

서버 이벤트를 추적하려면 서버 로그를 사용하십시오. 설정 파일의 [logger](/docs/ko/reference/settings/server-settings/settings#logger) 섹션을 참조하십시오.

ClickHouse는 다음을 수집합니다:

* 서버의 컴퓨팅 리소스 사용 방식에 대한 다양한 메트릭
* 쿼리 처리에 대한 일반적인 통계

메트릭은 [system.metrics](/docs/ko/reference/system-tables/metrics), [system.events](/docs/ko/reference/system-tables/events), [system.asynchronous\_metrics](/docs/ko/reference/system-tables/asynchronous_metrics) 테이블에서 확인할 수 있습니다.

ClickHouse를 구성하여 메트릭을 [Graphite](https://github.com/graphite-project)로 내보낼 수 있습니다. ClickHouse 서버 설정 파일의 [Graphite section](/docs/ko/reference/settings/server-settings/settings#graphite)을 참조하십시오. 메트릭 내보내기를 구성하기 전에 공식 [guide](https://graphite.readthedocs.io/en/latest/install.html)를 따라 먼저 Graphite를 설정해야 합니다.

ClickHouse를 구성하여 메트릭을 [Prometheus](https://prometheus.io)로 내보낼 수 있습니다. ClickHouse 서버 설정 파일의 [Prometheus section](/docs/ko/reference/settings/server-settings/settings#prometheus)을 참조하십시오. 메트릭 내보내기를 구성하기 전에 공식 [guide](https://prometheus.io/docs/prometheus/latest/installation/)를 따라 먼저 Prometheus를 설정해야 합니다.

또한 HTTP API를 통해 서버 가용성을 모니터링할 수 있습니다. `/ping`으로 `HTTP GET` 요청을 보내십시오. 서버를 사용할 수 있으면 `200 OK`로 응답합니다.

클러스터 환경에서 서버를 모니터링하려면 [max\_replica\_delay\_for\_distributed\_queries](/docs/ko/reference/settings/session-settings#max_replica_delay_for_distributed_queries) 매개변수를 설정하고 HTTP 리소스 `/replicas_status`를 사용해야 합니다. `/replicas_status`에 요청을 보내면 레플리카를 사용할 수 있고 다른 레플리카보다 지연되지 않은 경우 `200 OK`를 반환합니다. 레플리카가 지연된 경우에는 그 차이에 대한 정보와 함께 `503 HTTP_SERVICE_UNAVAILABLE`를 반환합니다.