> ## 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.

> 이 테이블에는 즉시 계산되어 Prometheus 포맷으로 내보낼 수 있는 히스토그램 메트릭이 포함되어 있습니다. 이 테이블은 항상 최신 상태입니다.

# system.histogram_metrics

<Info>
  **ClickHouse Cloud에서 쿼리하기**

  이 시스템 테이블의 데이터는 ClickHouse Cloud의 각 노드에 로컬로 저장됩니다. 따라서 전체 데이터를 모두 확인하려면 `clusterAllReplicas` 함수를 사용해야 합니다. 자세한 내용은 [여기](/docs/ko/reference/system-tables/overview#system-tables-in-clickhouse-cloud)를 참조하십시오.
</Info>

<div id="description">
  ## 설명
</div>

이 테이블(table)에는 즉시 계산되어 Prometheus 포맷으로 내보낼 수 있는 히스토그램 메트릭이 포함되어 있습니다. 항상 최신 상태입니다. 더 이상 사용이 권장되지 않는 `system.latency_log`를 대체합니다.

<div id="columns">
  ## 컬럼
</div>

* `metric` ([String](/docs/ko/reference/data-types/string)) — 메트릭 이름.
* `value` ([Float64](/docs/ko/reference/data-types/float)) — 메트릭 값.
* `description` ([String](/docs/ko/reference/data-types/string)) — 메트릭 설명.
* `labels` ([Map(String, String)](/docs/ko/reference/data-types/map)) — 메트릭 레이블.

**별칭:**

* `name` — `metric`의 별칭.

<div id="example">
  ## 예시
</div>

다음과 같은 쿼리를 사용하면 모든 히스토그램 메트릭을 Prometheus 포맷으로 내보낼 수 있습니다.

```sql theme={null}
SELECT
  metric AS name,
  toFloat64(value) AS value,
  description AS help,
  labels,
  'histogram' AS type
FROM system.histogram_metrics
FORMAT Prometheus
```

<div id="metric_descriptions">
  ## 메트릭 설명
</div>

| 메트릭                                                          | 설명                                                                                |
| ------------------------------------------------------------ | --------------------------------------------------------------------------------- |
| `keeper_response_time_ms_bucket`                             | Keeper의 응답 시간입니다. 단위는 밀리초입니다.                                                     |
| `keeper_client_queue_duration_milliseconds_bucket`           | 요청이 enqueued되기를 기다리는 시간과 Keeper 클라이언트에서 처리되기 전까지 큐에서 대기하는 시간입니다. 단위는 밀리초입니다.      |
| `keeper_receive_request_time_milliseconds_bucket`            | Keeper TCP handler에서 클라이언트의 요청을 수신하고 파싱하는 데 걸리는 시간입니다. 단위는 밀리초입니다.                |
| `keeper_dispatcher_requests_queue_time_milliseconds_bucket`  | 요청이 Keeper 디스패처 요청 큐에서 대기하는 시간입니다. 단위는 밀리초입니다.                                    |
| `keeper_write_pre_commit_time_milliseconds_bucket`           | Raft commit 전에 쓰기 요청을 전처리하는 데 걸리는 시간입니다. 단위는 밀리초입니다.                              |
| `keeper_write_commit_time_milliseconds_bucket`               | Raft commit 후에 쓰기 요청을 처리하는 데 걸리는 시간입니다. 단위는 밀리초입니다.                               |
| `keeper_dispatcher_responses_queue_time_milliseconds_bucket` | 응답이 Keeper 디스패처 응답 큐에서 대기하는 시간입니다. 단위는 밀리초입니다.                                    |
| `keeper_send_response_time_milliseconds_bucket`              | Keeper TCP handler에서 클라이언트로 응답을 보내는 데 걸리는 시간입니다(큐 대기 및 socket 쓰기 포함). 단위는 밀리초입니다. |
| `keeper_read_wait_for_write_time_milliseconds_bucket`        | 읽기 요청이 의존하는 쓰기 요청이 완료될 때까지 대기하는 시간입니다. 단위는 밀리초입니다.                                |
| `keeper_read_process_time_milliseconds_bucket`               | Keeper에서 읽기 요청을 처리하는 데 걸리는 시간입니다. 단위는 밀리초입니다.                                     |
| `keeper_batch_size_elements_bucket`                          | Raft로 전송되는 Batch 크기입니다. 단위는 원소 수입니다.                                              |
| `keeper_batch_size_bytes_bucket`                             | Raft로 전송되는 Batch 크기입니다. 단위는 바이트입니다.                                               |
| `filesystem_cache_evicted_segment_hits_bucket`               | 파일 세그먼트가 eviction되는 시점의 캐시 히트 횟수 분포이며, 캐시 이름으로 레이블이 지정됩니다.                        |
| `filesystem_cache_evicted_segment_size_bytes_bucket`         | eviction된 파일 세그먼트의 바이트 크기 분포이며, 캐시 이름으로 레이블이 지정됩니다.                               |
| `filesystem_cache_evicted_segment_hits_by_user_bucket`       | eviction된 파일 세그먼트의 캐시 히트 횟수 분포이며, 캐시 이름과 사용자 ID로 레이블이 지정됩니다.                      |
| `filesystem_cache_evicted_segment_size_bytes_by_user_bucket` | eviction된 파일 세그먼트의 바이트 크기 분포이며, 캐시 이름과 사용자 ID로 레이블이 지정됩니다.                        |

<div id="see-also">
  ## 관련 항목
</div>

* [system.asynchronous\_metrics](/docs/ko/reference/system-tables/asynchronous_metrics) — 주기적으로 계산된 메트릭을 포함합니다.
* [system.events](/docs/ko/reference/system-tables/events) — 발생한 여러 이벤트를 포함합니다.
* [system.metric\_log](/docs/ko/reference/system-tables/metric_log) — `system.metrics` 및 `system.events` 테이블의 메트릭 값 이력을 포함합니다.
* [모니터링](/docs/ko/guides/oss/deployment-and-scaling/monitoring/monitoring) — ClickHouse 모니터링의 기본 개념을 설명합니다.