asynchronous_metrics_* 서버 설정

asynchronous_metrics_* 서버 설정

이 페이지에서는 무거운 비동기 메트릭 계산, Keeper 전용 메트릭, key-value 메트릭의 공개 형식 등을 제어하는 asynchronous_metrics_* 계열 서버 설정을 설명할게요.

출처: 문서

본문

이 설정들은 ClickHouse 서버를 구성하며, ClickHouse 소스에서 자동으로 생성돼요.

asynchronous_metrics_enable_heavy_metrics

무거운 비동기 메트릭의 계산을 활성화해요.

asynchronous_metrics_keeper_metrics_only

비동기 메트릭이 keeper 관련 메트릭만 계산하게 해요.

asynchronous_metrics_key_values_mode

CPU 코어, 블록 장치, 네트워크 인터페이스, 디스크, 온도 센서, 메모리 컨트롤러 또는 로깅 채널별로 분류되는 key-value 비동기 메트릭이 system.asynchronous_metrics, system.asynchronous_metric_log, Prometheus 엔드포인트 및 Graphite에 공개되는 형식이에요.

가능한 값:

  • key_values — 모든 패밀리가 단일 key-value 메트릭이에요: system.asynchronous_metricskey_values 컬럼에 Map, system.asynchronous_metric_log에는 키당 한 행, Prometheus에는 device="sda" 같은 라벨을 가진 키당 하나의 샘플, 그리고 <prefix>.<Metric>.<key> Graphite 경로로 공개돼요.
  • legacy_names — 버전 26.8 이전처럼 모든 키가 이름에 키가 들어간 별도의 스칼라 메트릭이에요: OSUserTimeCPU3, CPUFrequencyMHz_0, BlockReadBytes_sda, NetworkReceiveBytes_eth0, DiskTotal_default, Temperature0, EDAC0_Correctable 등이에요.
  • both — 두 형식을 동시에 공개해요. 모니터링을 마이그레이션하는 동안 유용해요. 이 모드에서는 이중 계산에 주의하세요: sum(value) ... WHERE metric LIKE 'NetworkReceiveBytes%'처럼 메트릭 이름이 접두사와 일치하는 집계는 모든 값을 두 번씩 세요.

버전 26.8 이후에 도입된 key-value 메트릭 패밀리는 레거시 이름이 없으며 항상 key-value 형식으로 공개돼요.

이 설정은 즉시 적용돼요: 비동기 메트릭이 업데이트될 때마다 다시 읽히므로, 형식을 전환하려면 재시작 없이 SYSTEM RELOAD CONFIG만으로 충분해요.

asynchronous_metrics_update_period_s

비동기 메트릭을 업데이트하는 주기(초)예요.

더 알아보기 (Learn more)