histogram_metrics 시스템 테이블
histogram_metrics 시스템 테이블
histogram_metrics 시스템 테이블은 즉시 계산되어 Prometheus 포맷으로 내보낼 수 있는 히스토그램 메트릭을 담고 있어요. 항상 최신 상태를 유지하며, 더 이상 사용되지 않는 system.latency_log를 대체해요.
출처: 문서
본문
Querying in ClickHouse Cloud 이 시스템 테이블의 데이터는 ClickHouse Cloud의 각 노드에 로컬로 보관돼요. 따라서 모든 데이터에 대한 완전한 뷰를 얻으려면 clusterAllReplicas 함수가 필요해요. 자세한 내용은 여기를 참고해요.
Description (설명)
이 테이블은 즉시 계산되어 Prometheus 포맷으로 내보낼 수 있는 히스토그램 메트릭을 담고 있어요. 항상 최신 상태를 유지하며, 더 이상 사용되지 않는 system.latency_log를 대체해요.
Metric descriptions (메트릭 설명)
| Metric | Description |
|---|---|
| keeper_response_time_ms_bucket | Keeper의 응답 시간(밀리초). |
| keeper_client_queue_duration_milliseconds_bucket | 요청이 Keeper 클라이언트에 의해 처리되기 전에 인큐 대기와 큐 대기에 소요된 시간(밀리초). |
| keeper_receive_request_time_milliseconds_bucket | Keeper TCP 핸들러에서 클라이언트의 요청을 수신하고 파싱하는 시간(밀리초). |
| keeper_dispatcher_requests_queue_time_milliseconds_bucket | 요청이 Keeper 디스패처 요청 큐에서 보내는 시간(밀리초). |
| keeper_write_pre_commit_time_milliseconds_bucket | Raft 커밋 전에 쓰기 요청을 전처리하는 시간(밀리초). |
| keeper_write_commit_time_milliseconds_bucket | Raft 커밋 후에 쓰기 요청을 처리하는 시간(밀리초). |
| keeper_dispatcher_responses_queue_time_milliseconds_bucket | 응답이 Keeper 디스패처 응답 큐에서 보내는 시간(밀리초). |
| keeper_send_response_time_milliseconds_bucket | Keeper TCP 핸들러에서 클라이언트에 응답을 보내는 시간(큐잉과 소켓 쓰기 포함, 밀리초). |
| keeper_read_wait_for_write_time_milliseconds_bucket | 읽기 요청이 그것이 의존하는 쓰기 요청이 완료되기를 기다리는 시간(밀리초). |
| keeper_read_process_time_milliseconds_bucket | Keeper에서 읽기 요청을 처리하는 시간(밀리초). |
| keeper_batch_size_elements_bucket | Raft에 보내진 배치 크기(요소). |
| keeper_batch_size_bytes_bucket | Raft에 보내진 배치 크기(바이트). |
| filesystem_cache_evicted_segment_hits_bucket | 파일 세그먼트가 축출될 때의 캐시 적중 수 분포. 캐시 이름으로 라벨링됨. |
| filesystem_cache_evicted_segment_size_bytes_bucket | 축출된 파일 세그먼트의 바이트 크기 분포. 캐시 이름으로 라벨링됨. |
| filesystem_cache_evicted_segment_hits_by_user_bucket | 축출된 파일 세그먼트의 캐시 적중 수 분포. 캐시 이름과 사용자 id로 라벨링됨. |
| filesystem_cache_evicted_segment_size_bytes_by_user_bucket | 축출된 파일 세그먼트의 바이트 크기 분포. 캐시 이름과 사용자 id로 라벨링됨. |
Columns (열)
metric(String) — 메트릭 이름.value(Float64) — 메트릭 값.description(String) — 메트릭 설명.labels(Map(String, String)) — 메트릭 라벨.
Aliases (별칭):
name—metric의 별칭.
Example (예제)
이런 쿼리로 모든 히스토그램 메트릭을 Prometheus 포맷으로 내보낼 수 있어요.
SELECT
metric AS name,
toFloat64(value) AS value,
description AS help,
labels,
'histogram' AS type
FROM system.histogram_metrics
FORMAT Prometheus
See Also (참고)
- system.asynchronous_metrics — 주기적으로 계산되는 메트릭을 담고 있어요.
- system.events — 발생한 이벤트의 수를 담고 있어요.
- system.metric_log — 테이블
system.metrics와system.events의 메트릭 값 내역을 담고 있어요. - Monitoring — ClickHouse 모니터링의 기본 개념.