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

> ハードウェアリソースの使用状況に加えて、ClickHouse サーバーのメトリクスも監視できます。

# 監視

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<Note>
  このガイドで説明する監視データは、ClickHouse Cloud で利用できます。以下で説明する組み込みダッシュボードで表示できるほか、基本的なものから高度なものまで、パフォーマンスメトリクスをメインのサービスコンソールで直接確認することもできます。
</Note>

次の項目を監視できます。

* ハードウェアリソースの使用状況
* ClickHouse server のメトリクス

<div id="built-in-advanced-observability-dashboard">
  ## 組み込みの高度なオブザーバビリティダッシュボード
</div>

<Image img="https://mintcdn.com/private-7c7dfe99/nYSl14_LxtbSRLxz/images/cloud/manage/monitoring/native_advanced_dashboard.webp?fit=max&auto=format&n=nYSl14_LxtbSRLxz&q=85&s=38edf643d858dbc9d2c666025a1b104d" alt="ネイティブの高度なオブザーバビリティダッシュボード" size="md" width="1600" height="870" data-path="images/cloud/manage/monitoring/native_advanced_dashboard.webp" />

ClickHouse には組み込みの高度なオブザーバビリティダッシュボード機能があり、`$HOST:$PORT/dashboard` でアクセスできます (ユーザー名とパスワードが必要です) 。このダッシュボードでは、次のメトリクスを確認できます。

* クエリ/秒
* CPU 使用率 (コア)
* 実行中のクエリ
* 実行中のマージ
* 選択バイト数/秒
* I/O wait
* CPU wait
* OS CPU 使用率 (ユーザー空間)
* OS CPU 使用率 (カーネル)
* ディスクからの読み取り
* ファイルシステムからの読み取り
* メモリ (追跡対象)
* 挿入行数/秒
* MergeTree パーツの合計数
* パーティションあたりの最大パーツ数

<div id="resource-utilization">
  ## リソース使用率
</div>

ClickHouse は、次のようなハードウェアリソースの状態も独自に監視しています。

* プロセッサの負荷と温度。
* ストレージシステム、RAM、ネットワークの使用状況。

このデータは `system.asynchronous_metric_log` テーブルに収集されます。

<div id="clickhouse-server-metrics">
  ## ClickHouse server のメトリクス
</div>

ClickHouse server には、自身の状態を監視するための計測機能が組み込まれています。

サーバーイベントを追跡するには、サーバーログを使用します。設定ファイルの [logger](/docs/ja/reference/settings/server-settings/settings#logger) セクションを参照してください。

ClickHouse が収集するもの:

* サーバーの計算リソース使用状況に関する各種メトリクス。
* クエリ処理に関する一般的な統計情報。

メトリクスは、[system.metrics](/docs/ja/reference/system-tables/metrics)、[system.events](/docs/ja/reference/system-tables/events)、および [system.asynchronous\_metrics](/docs/ja/reference/system-tables/asynchronous_metrics) テーブルで確認できます。

ClickHouse は、メトリクスを [Graphite](https://github.com/graphite-project) にエクスポートするよう設定できます。ClickHouse server の設定ファイルにある [Graphite セクション](/docs/ja/reference/settings/server-settings/settings#graphite) を参照してください。メトリクスのエクスポートを設定する前に、公式の [ガイド](https://graphite.readthedocs.io/en/latest/install.html) に従って Graphite をセットアップしておく必要があります。

ClickHouse は、メトリクスを [Prometheus](https://prometheus.io) にエクスポートするよう設定できます。ClickHouse server の設定ファイルにある [Prometheus セクション](/docs/ja/reference/settings/server-settings/settings#prometheus) を参照してください。メトリクスのエクスポートを設定する前に、公式の [ガイド](https://prometheus.io/docs/prometheus/latest/installation/) に従って Prometheus をセットアップしておく必要があります。

さらに、HTTP API を介してサーバーの可用性を監視できます。`HTTP GET` リクエストを `/ping` に送信します。サーバーが利用可能な場合は、`200 OK` を返します。

クラスター構成でサーバーを監視するには、[max\_replica\_delay\_for\_distributed\_queries](/docs/ja/reference/settings/session-settings#max_replica_delay_for_distributed_queries) パラメータを設定し、HTTP リソース `/replicas_status` を使用する必要があります。`/replicas_status` へのリクエストは、レプリカが利用可能で、かつ他のレプリカに対して遅延していない場合に `200 OK` を返します。レプリカが遅延している場合は、その差分に関する情報とともに `503 HTTP_SERVICE_UNAVAILABLE` を返します。
