system.histogram_metrics - ClickHouse Documentation

ClickHouse Cloud でのクエリこのシステムテーブルのデータは、ClickHouse Cloud の各ノードにローカルに保持されています。したがって、すべてのデータを完全に把握するには、clusterAllReplicas 関数を使用する必要があります。詳細については、こちらを参照してください。

説明

このテーブルには、即時に計算でき、Prometheus フォーマットでエクスポート可能なヒストグラムメトリクスが含まれています。内容は常に最新です。非推奨の system.latency_log を置き換えるものです。

メトリクスの説明

メトリック	説明
`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 ハンドラーでクライアントにレスポンスを送信する時間 (キューでの待機および socket への書き込みを含む、ミリ秒) 。
`keeper_read_wait_for_write_time_milliseconds_bucket`	読み取りリクエストが、依存先の書き込みリクエストの完了を待機する時間 (ミリ秒) 。
`keeper_read_process_time_milliseconds_bucket`	Keeper で読み取りリクエストを処理する時間 (ミリ秒) 。
`keeper_batch_size_elements_bucket`	Raft に送信される Batch サイズ (elements 単位) 。
`keeper_batch_size_bytes_bucket`	Raft に送信される Batch サイズ (バイト単位) 。
`filesystem_cache_evicted_segment_hits_bucket`	エビクション時点におけるファイルセグメントの cache ヒット回数の分布。cache 名ごとにラベル付けされます。
`filesystem_cache_evicted_segment_size_bytes_bucket`	追い出されたファイルセグメントのバイトサイズの分布。cache 名ごとにラベル付けされます。
`filesystem_cache_evicted_segment_hits_by_user_bucket`	追い出されたファイルセグメントの cache ヒット回数の分布。cache 名と user id ごとにラベル付けされます。
`filesystem_cache_evicted_segment_size_bytes_by_user_bucket`	追い出されたファイルセグメントのバイトサイズの分布。cache 名と user id ごとにラベル付けされます。

カラム

metric (String) — メトリック名。
value (Float64) — メトリック値。
description (String) — メトリックの説明。
labels (Map(String, String)) — メトリックのラベル。

別名:

name — metric の別名。

例

次のようなクエリを使用すると、すべてのヒストグラムメトリクスをPrometheusフォーマットでエクスポートできます。

SELECT
  metric AS name,
  toFloat64(value) AS value,
  description AS help,
  labels,
  'histogram' AS type
FROM system.histogram_metrics
FORMAT Prometheus

関連項目

system.asynchronous_metrics — 定期的に計算されるメトリクスが含まれています。
system.events — 発生した各種イベントが含まれています。
system.metric_log — テーブル system.metrics と system.events のメトリクスの値の履歴が含まれています。
監視 — ClickHouse の監視に関する基本概念。

最終更新日 2026年9月26日