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

# system.histogram_metrics

> このテーブルには、即座に計算でき、Prometheusフォーマットでエクスポートできるヒストグラムメトリクスが含まれています。常に最新の状態です。

> [!NOTE]
>
> **ClickHouse Cloud でのクエリ**
>
> このシステムテーブルのデータは、ClickHouse Cloud の各ノードにローカルに保持されています。したがって、すべてのデータを完全に把握するには、`clusterAllReplicas` 関数を使用する必要があります。詳細については、[こちら](https://clickhouse.com/docs/ja/reference/system-tables/overview.md#system-tables-in-clickhouse-cloud)を参照してください。

## 説明

このテーブルには、即時に計算でき、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](https://clickhouse.com/docs/ja/reference/data-types/string.md)) — メトリック名。
* `value` ([Float64](https://clickhouse.com/docs/ja/reference/data-types/float.md)) — メトリック値。
* `description` ([String](https://clickhouse.com/docs/ja/reference/data-types/string.md)) — メトリックの説明。
* `labels` ([Map(String, String)](https://clickhouse.com/docs/ja/reference/data-types/map.md)) — メトリックのラベル。

**別名:**

* `name` — `metric` の別名。

## 例

次のようなクエリを使用すると、すべてのヒストグラムメトリクスを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
```

## 関連項目

* [system.asynchronous\_metrics](https://clickhouse.com/docs/ja/reference/system-tables/asynchronous_metrics.md) — 定期的に計算されるメトリクスが含まれています。
* [system.events](https://clickhouse.com/docs/ja/reference/system-tables/events.md) — 発生した各種イベントが含まれています。
* [system.metric\_log](https://clickhouse.com/docs/ja/reference/system-tables/metric_log.md) — テーブル `system.metrics` と `system.events` のメトリクスの値の履歴が含まれています。
* [監視](https://clickhouse.com/docs/ja/guides/oss/deployment-and-scaling/monitoring/monitoring.md) — ClickHouse の監視に関する基本概念。
