system.asynchronous_metrics - ClickHouse Documentation

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

説明

バックグラウンドで定期的に計算されるメトリクスが含まれます。たとえば、使用中のRAM量です。

カラム

metric (String) — メトリクス名。
value (Float64) — メトリクスの値。
description (String - メトリクスの説明)

例

SELECT * FROM system.asynchronous_metrics LIMIT 10

┌─metric──────────────────────────────────┬──────value─┬─description────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ AsynchronousMetricsCalculationTimeSpent │ 0.00179053 │ Time in seconds spent for calculation of asynchronous metrics (this is the overhead of asynchronous metrics).                                                                                                                                              │
│ NumberOfDetachedByUserParts             │          0 │ The total number of parts detached from MergeTree tables by users with the `ALTER TABLE DETACH` query (as opposed to unexpected, broken or ignored parts). The server does not care about detached parts and they can be removed.                          │
│ NumberOfDetachedParts                   │          0 │ The total number of parts detached from MergeTree tables. A part can be detached by a user with the `ALTER TABLE DETACH` query or by the server itself it the part is broken, unexpected or unneeded. The server does not care about detached parts and they can be removed. │
│ TotalRowsOfMergeTreeTables              │    2781309 │ Total amount of rows (records) stored in all tables of MergeTree family.                                                                                                                                                                                   │
│ TotalBytesOfMergeTreeTables             │    7741926 │ Total amount of bytes (compressed, including data and indices) stored in all tables of MergeTree family.                                                                                                                                                   │
│ NumberOfTables                          │         93 │ Total number of tables summed across the databases on the server, excluding the databases that cannot contain MergeTree tables. The excluded database engines are those who generate the set of tables on the fly, like `Lazy`, `MySQL`, `PostgreSQL`, `SQlite`. │
│ NumberOfDatabases                       │          6 │ Total number of databases on the server.                                                                                                                                                                                                                   │
│ MaxPartCountForPartition                │          6 │ Maximum number of parts per partition across all partitions of all tables of MergeTree family. Values larger than 300 indicates misconfiguration, overload, or massive data loading.                                                                       │
│ ReplicasSumMergesInQueue                │          0 │ Sum of merge operations in the queue (still to be applied) across Replicated tables.                                                                                                                                                                       │
│ ReplicasSumInsertsInQueue               │          0 │ Sum of INSERT operations in the queue (still to be replicated) across Replicated tables.                                                                                                                                                                   │
└─────────────────────────────────────────┴────────────┴────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

メトリクスの説明

以下の説明は、utils/generate-async-metrics-docs によって C++ ソースコードから生成されています。唯一の信頼できる情報源は、src/Common/AsynchronousMetrics.cpp、src/Interpreters/ServerAsynchronousMetrics.cpp、および src/Coordination/KeeperAsynchronousMetrics.cpp にある、各メトリクス登録の横の文字列リテラルです。可変の接尾辞 (ディスクごと、CPU ごと、インターフェイスごと、…) を含むメトリクス名は、*name* プレースホルダーを使って表されています。稼働中のサーバーでは、これらは具体的な接尾辞に置き換えられて報告されます。

nameDeadBlobsQueueEstimate

ディスクのオブジェクトストレージから削除するためにエンキューされているブロブの推定数 (ブロブマネージャーのデッドキュー) 。ブロブレプリケーションを使用していないディスクでは 0 が報告されます。

nameMissingBlobsQueueEstimate

ディスク上の他の場所へのレプリケーションを待機中のブロブ数の推定値 (ブロブマネージャーの未処理キュー) 。ブロブのレプリケーションを行わないディスクでは 0 が報告されます。

AsynchronousHeavyMetricsCalculationTimeSpent

非同期の高負荷な (テーブル関連の) メトリクスの計算に要した時間 (秒) です (これは非同期メトリクスのオーバーヘッドです) 。

AsynchronousHeavyMetricsUpdateInterval

高負荷な (テーブル関連の) メトリクスの更新間隔

AsynchronousMetricsCalculationTimeSpent

非同期メトリクスの計算に要した時間 (秒) (これは非同期メトリクスによるオーバーヘッドです) 。

AsynchronousMetricsUpdateInterval

メトリクス更新間隔

AsyncLoggingmetric_firstQueueSize

このチャネルでログ出力待ちとしてキューに入っている非同期メッセージ数

BlockActiveTime_name

ブロックデバイスで I/O リクエストがキューに入っていた時間を秒単位で示します。これはシステム全体のメトリックであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスを含みます。ソース: /sys/block。https://www.kernel.org/doc/Documentation/block/stat.txt を参照してください

BlockActiveTimePerOp_name

BlockActiveTime メトリクスと同様ですが、1回あたりのI/O操作時間を算出するため、値をI/O操作回数で割っています。

BlockDiscardBytes_name

ブロックデバイスで破棄されたバイト数。この種の discard 操作は SSD で重要になります。discard 操作は ClickHouse では使われませんが、システム上の他のプロセスで使われることがあります。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。ソース: /sys/block。https://www.kernel.org/doc/Documentation/block/stat.txt を参照してください。

BlockDiscardMerges_name

OS の I/O スケジューラによって、ブロックデバイスに要求された discard operations がまとめてマージされた回数です。これらの操作は SSD に関連します。Discard operations は ClickHouse では使用されませんが、システム上のほかのプロセスで使用されることがあります。これはシステム全体のメトリックであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。ソース: /sys/block。詳しくは https://www.kernel.org/doc/Documentation/block/stat.txt を参照してください

BlockDiscardOps_name

ブロックデバイスに対して要求された discard 操作の回数です。これらの操作は SSD に関連します。discard 操作は ClickHouse では使用されませんが、システム上の他のプロセスで使用されることがあります。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。ソース: /sys/block。https://www.kernel.org/doc/Documentation/block/stat.txt を参照してください。

BlockDiscardTime_name

ブロックデバイスに要求された discard operations に費やされた時間を秒単位で表したもので、すべての操作の合計です。これらの操作は SSD に関連します。discard operations は ClickHouse では使用されませんが、システム上の他のプロセスで使用されることがあります。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。ソース: /sys/block。https://www.kernel.org/doc/Documentation/block/stat.txt を参照してください。

BlockInFlightOps_name

この値は、デバイスドライバーに発行されたものの、まだ完了していない I/O リクエスト数を表します。キューに入っていても、まだデバイスドライバーに発行されていない I/O リクエストは含まれません。これはシステム全体のメトリックであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが対象です。ソース: /sys/block。https://www.kernel.org/doc/Documentation/block/stat.txt を参照してください

BlockQueueTime_name

この値は、このブロックデバイス上で I/O リクエストが待機した時間をミリ秒単位でカウントします。待機中の I/O リクエストが複数ある場合、この値は、待機時間 (ミリ秒) と待機中のリクエスト数の積に応じて増加します。これはシステム全体のメトリックであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。ソース: /sys/block。https://www.kernel.org/doc/Documentation/block/stat.txt を参照してください

BlockQueueTimePerOp_name

BlockQueueTimeメトリクスと同様ですが、値をI/O操作数で割ることで、1操作あたりの時間を表します。

BlockReadBytes_name

ブロックデバイスから読み取られたバイト数。I/O を節約する OS page cache が使用されるため、ファイルシステムから読み取られたバイト数より少なくなることがあります。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。ソース: /sys/block。https://www.kernel.org/doc/Documentation/block/stat.txt を参照してください。

BlockReadMerges_name

ブロックデバイスに対して要求され、OS の I/O スケジューラによってまとめてマージされた読み取り操作の回数です。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。ソース: /sys/block。https://www.kernel.org/doc/Documentation/block/stat.txt を参照してください。

BlockReadOps_name

ブロックデバイスに対して要求された読み取り操作の回数です。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。ソース: /sys/block。詳細は https://www.kernel.org/doc/Documentation/block/stat.txt を参照してください

BlockReadTime_name

ブロックデバイスに要求された読み取り操作に費やされた時間を秒単位で表したもので、すべての操作の合計です。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。ソース: /sys/block。https://www.kernel.org/doc/Documentation/block/stat.txt を参照してください

BlockWriteBytes_name

ブロックデバイスに書き込まれたバイト数です。I/O を節約する OS ページキャッシュの使用により、ファイルシステムに書き込まれたバイト数より少なくなることがあります。ライトスルーキャッシュのため、ブロックデバイスへの書き込みは、対応するファイルシステムへの書き込みより後に行われる場合があります。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。出典: /sys/block。https://www.kernel.org/doc/Documentation/block/stat.txt を参照してください。

BlockWriteMerges_name

ブロックデバイスに対して要求され、OS の I/O スケジューラによってまとめてマージされた書き込み操作の回数です。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが対象です。ソース: /sys/block。https://www.kernel.org/doc/Documentation/block/stat.txt を参照してください。

BlockWriteOps_name

ブロックデバイスに対して要求された書き込み操作の回数です。これはシステム全体のメトリックであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。ソース: /sys/block。詳しくは https://www.kernel.org/doc/Documentation/block/stat.txt を参照してください。

BlockWriteTime_name

ブロックデバイスに対して要求された書き込み操作に費やされた時間を秒単位で表したもので、すべての操作の合計です。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。出典: /sys/block。https://www.kernel.org/doc/Documentation/block/stat.txt を参照してください。

CGroupMaxCPU

CGroups に基づく CPU コア数の最大値です。

CGroupMemoryTotal

cgroup 内のメモリの総量 (バイト単位) です。0 の場合、制限は OSMemoryTotal と同じです。

CGroupMemoryUsed

cgroup で使用されているメモリ量 (バイト単位) 。cgroup v2 では anon + sock + 再利用不可のカーネルメモリ、cgroup v1 では RSS を指します。いずれの場合も、カーネルの OS page cache (ファイルバックされた cache) は含まれません。

CGroupMemoryUsedWithoutPageCache

cgroup で使用されているメモリ量 (バイト単位) から、ClickHouse のユーザー空間ページキャッシュを除いた値です。これは CGroupMemoryUsed からユーザー空間ページキャッシュのサイズを差し引いた値です。ユーザー空間ページキャッシュが無効な場合、この値は CGroupMemoryUsed と同じになります。

CGroupSystemTime

CPU コアが OS カーネル (system) コードを実行していた時間の比率です。

CGroupSystemTimeNormalized

この値は CGroupSystemTime に似ていますが、利用可能な CPU コア数で割ることで、コア数にかかわらず [0..1] の範囲で測定されます。これにより、クラスター内の複数のサーバーで CPU コア数にばらつきがある場合でも、このメトリクスの値を平均し、平均的なリソース使用状況のメトリクスを得ることができます。指定されている場合は、実際の CPU コア数の代わりに、Cgroup CPU QUOTA をその period で割った値を使用できます。この場合、このメトリクスの値が一時的に 1 を超えることがあります。

CGroupUserTime

CPU コアがユーザー空間のコードを実行していた時間の比率です。これには、CPU 内部の要因 (メモリロード、パイプラインストール、ブランチ予測ミス、別の SMT コアの実行) によって CPU を十分に活用できなかった時間も含まれます。

CGroupUserTimeNormalized

この値は CGroupUserTime に似ていますが、利用可能な CPU コア数で割ることで、コア数に関係なく [0..1] の範囲で測定できるようになります。これにより、クラスター内の複数のサーバーにまたがって、このメトリクスの値を、コア数が均一でない場合でも平均化し、平均的なリソース使用状況メトリクスを得ることができます。指定した場合は、実際の CPU コア数の代わりに、Cgroup CPU quota をその period で割った値を使用できます。その場合、このメトリクスの値が一時的に 1 を超えることがあります。

CompiledExpressionCacheBytesMax

コンパイル済み式キャッシュの設定上限バイト数。利用可能なヘッドルーム = この値 - CompiledExpressionCacheBytes (CurrentMetric) 。

CompiledExpressionCacheCountMax

コンパイル済み式キャッシュに設定できる最大エントリ数。利用可能なヘッドルーム = この値 - CompiledExpressionCacheCount (CurrentMetric) 。

CPUFrequencyMHz_core_id

CPU の現在の動作周波数 (MHz) です。最新の CPU の多くは、省電力や Turbo Boost のために周波数を動的に調整します。

DictionaryMaxUpdateDelay

Dictionary 更新の最大遅延時間 (秒)

DictionaryTotalFailedUpdates

すべてのDictionaryにおいて、最後に正常に読み込まれてから発生したエラー数。

DiskAvailable_name

ディスク (仮想ファイルシステム) 上で利用可能なバイト数。リモートfilesystemでは、この情報が提供されない場合があり、16 EiB のような非常に大きな値が表示されることがあります。

DiskGetObjectThrottlerAvailable_name

ディスク (仮想ファイルシステム) でスロットリング制限に達せずに現在発行できる GetObject リクエストの数。ローカルファイルシステムでは、この情報を取得できない場合があります。

DiskGetObjectThrottlerRPS_name

ディスク上の GetObject リクエストに対するスロットリングの上限 (1 秒あたりのリクエスト数、仮想ファイルシステム) 。ローカルファイルシステムでは、この情報を取得できない場合があります。

DiskPutObjectThrottlerAvailable_name

ディスク (仮想ファイルシステム) でスロットリング制限に達することなく、現在発行可能な PutObject リクエスト数。ローカルファイルシステムでは、この情報が提供されない場合があります。

DiskPutObjectThrottlerRPS_name

ディスク上の PutObject リクエストのスロットリング上限値です。単位は 1 秒あたりのリクエスト数です (仮想ファイルシステム) 。ローカルファイルシステムでは、この情報が提供されない場合があります。

DiskTotal_name

ディスク (仮想ファイルシステム) の総容量をバイト単位で表したものです。リモートファイルシステムでは、この情報が提供されない場合があり、16 EiB のような大きな値が表示されることがあります。

DiskUnreserved_name

マージ、フェッチ、移動の予約を差し引いた、ディスク (仮想ファイルシステム) の利用可能バイト数です。リモートファイルシステムでは、この情報が提供されない場合があり、16 EiB のような大きな値が表示されることがあります。

DiskUsed_name

ディスク (仮想ファイルシステム) で使用中のバイト数。リモートファイルシステムでは、この情報が常に提供されるとは限りません。

EDACi_Correctable

訂正可能な ECC メモリエラーの件数です。この値が多い場合は RAM の不良を示しており、直ちに交換する必要があります。訂正済みエラーが多発している場合、サイレントエラーも発生してデータ破損につながる可能性があるためです。ソース: /sys/devices/system/edac/mc/

EDACi_Uncorrectable

修正不能なECCメモリエラーの数です。この値がゼロ以外の場合は、不良RAMが存在し、データ破損の可能性があることを示しているため、直ちに交換する必要があります。ソース: /sys/devices/system/edac/mc/

ExecutableUserDefinedFunctionMemoryResidentBytes

実行可能および実行可能プールのユーザー定義関数と、その子孫プロセスに属する稼働中のすべてのプロセスにおける常駐セットサイズ (VmRSS) の合計値です。単位はバイトです。アイドル状態の実行可能プールワーカーも含まれます。共有ページはプロセスごとに1回ずつ計上されるため、この合計値は上限となり、UDF プロセス群の実際の物理メモリ使用量 (一意の使用量) を上回る場合があります。

ExecutableUserDefinedFunctionProcesses

実行可能および実行可能プールのユーザー定義関数用に起動された稼働中のプロセス数 (それらの子孫プロセスを含む) 。

FilesystemCacheBytes

cache 仮想ファイルシステム内の合計バイト数です。この cache はディスク上に保存されます。

FilesystemCacheCapacity

cache 仮想ファイルシステムの総容量です。この cache はディスク上に保存されます。

FilesystemCacheFiles

cache 仮想ファイルシステム内にある、キャッシュされたファイルセグメントの総数です。このキャッシュはディスク上に保持されます。

FilesystemLogsPathAvailableBytes

ClickHouse のログパスがマウントされているボリューム上の使用可能なバイト数です。この値がゼロに近づく場合は、設定ファイルでログローテーションを調整してください。

FilesystemLogsPathAvailableINodes

ClickHouse のログパスがマウントされているボリュームで利用可能な inode数。

FilesystemLogsPathTotalBytes

ClickHouse のログ保存先パスがマウントされているボリュームのサイズです。単位はバイトです。ログ用には少なくとも 10 GB を確保することを推奨します。

FilesystemLogsPathTotalINodes

ClickHouse のログパスがマウントされているボリューム上の inode の総数。

FilesystemLogsPathUsedBytes

ClickHouse のログパスがマウントされているボリューム上で使用されているバイト数。

FilesystemLogsPathUsedINodes

ClickHouse のログパスがマウントされているボリュームで使用中の inode 数。

FilesystemMainPathAvailableBytes

メインのClickHouseパスがマウントされているボリュームで使用可能なバイト数。

FilesystemMainPathAvailableINodes

メインの ClickHouse パスがマウントされているボリュームで使用可能な inode 数です。これがゼロに近い場合は設定の誤りを示しており、ディスクがいっぱいでなくても ‘no space left on device’ エラーが発生します。

FilesystemMainPathTotalBytes

メインの ClickHouse パスがマウントされているボリュームのサイズ (バイト単位) 。

FilesystemMainPathTotalINodes

ClickHouse のメインパスがマウントされているボリューム上の inode 総数です。これが 2,500 万未満の場合は、設定ミスを示しています。

FilesystemMainPathUsedBytes

ClickHouseのメインパスがマウントされているボリューム上で使用中のバイト数。

メインのClickHouseパスがマウントされているボリュームで使用中のinode数

メインのClickHouseパスがマウントされているボリュームで使用中のinodeの数です。通常、この値はファイル数にほぼ対応します。

GRPCRejectedConnections

GRPC プロトコルで拒否された接続の数。

GRPCThreads

GRPCプロトコルのサーバーにおけるスレッド数。

HashTableStatsCacheEntries

ハッシュテーブルのサイズに関するcache内のエントリ数です。このcacheは、GROUP BY の予測的最適化に使用されます。

HashTableStatsCacheHits

ハッシュテーブルのサイズ予測が正しかった回数。

HashTableStatsCacheMisses

ハッシュテーブルのサイズ予測が誤っていた回数。

HTTPConnectionPoolgroup_nameTCPRcvBufTotalBytes

すべての HTTP 接続プールソケットにおけるカーネルの TCP 受信バッファメモリ (sk_rmem_alloc) の合計。

HTTPConnectionPoolgroup_nameTCPSndBufTotalBytes

すべての HTTP 接続プールソケットにおける、カーネルの TCP 送信バッファメモリ (sk_wmem_alloc) の合計。

HTTPRejectedConnections

HTTP インターフェイス (TLS なし) で拒否された接続数。

HTTPSecureRejectedConnections

HTTPS インターフェイスで拒否された接続の数。

HTTPSecureThreads

HTTPSインターフェイスのサーバーにおけるスレッド数。

HTTPThreads

HTTP インターフェイスのサーバー内のスレッド数 (TLS なし) 。

InterserverRejectedConnections

レプリカ間通信プロトコル (TLS なし) で拒否された接続数。

InterserverSecureRejectedConnections

レプリカ間通信プロトコル (TLS 使用) で拒否された接続の数。

InterserverSecureThreads

レプリカ間通信プロトコルのサーバーにおけるスレッド数 (TLS 使用時) 。

InterserverThreads

TLS を使用しないレプリカ間通信プロトコルのサーバーにおけるスレッド数。

jemalloc.active

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.allocated

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。https://jemalloc.net/jemalloc.3.html を参照してください

jemalloc.arenas.all.dirty_purged

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。詳しくは https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.arenas.all.muzzy_purged

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。詳しくは https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.arenas.all.pactive

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。詳しくは https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.arenas.all.pdirty

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。詳しくは https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.arenas.all.pmuzzy

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。詳細は https://jemalloc.net/jemalloc.3.html を参照してください

jemalloc.arenas.dirty_decay_ms

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.background_thread.num_runs

低レベルメモリアロケータ (jemalloc) の内部メトリックです。詳しくは https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.background_thread.num_threads

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.background_thread.run_intervals

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.cache_arena.pactive

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.cache_arena.pdirty

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.epoch

他のすべてのjemallocメトリクスで使用される、jemalloc (Jason Evans のメモリアロケータ) の統計情報の内部的な更新番号です。

jemalloc.fragmentation

jemalloc.active と jemalloc.allocated の差。メモリアロケータ内の内部断片化 (割り当てにより完全には使用されていないアクティブなページ) を表します。

jemalloc.jit_arena.active_bytes

専用の jemalloc JIT アリーナでアクティブに使用されているバイト数。(a) LLVM ヒープの状態 (TargetMachine とそのターゲット固有の Subtarget、IR モジュール、最適化パスの解析、RuntimeDyld の再配置テーブル) と、(b) JITModuleMemoryManager が実行可能セクションおよびデータセクション用に posix_memalign 経由で割り当てる、ページ境界に整列された予約ブロック (je_posix_memalign にインターセプトされるため jemalloc を経由します) の両方を含みます。CompiledExpressionCacheBytes (CurrentMetric) はこの一部であり、実行可能セクションおよびデータセクション用の予約済みページブロック容量のみを追跡します。これらのブロック内で実際に使用されているコードまたはデータのバイト数は追跡しません。

jemalloc.jit_arena.dirty_bytes

OS にパージして返却可能な、JIT アリーナ内のダーティバイト数。

jemalloc.jit_arena.pactive

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.jit_arena.pdirty

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.mapped

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.mergetree_arena.active_bytes

専用の jemalloc MergeTree アリーナプール (jemalloc.mergetree_arena.count アリーナ) 全体で合計したアクティブなバイト数です。長期間存続する MergeTree のヒープ状態を保持します。これには、パーツごとのメタデータ (SerializationInfoByName、MergeTreeDataPartChecksums tree、各 IMergeTreeDataPart 内の Poco::LRUCache<String, ColumnSize> delegates、パーツごとの ColumnSize/IndexSize maps、MinMaxIndex、VersionMetadataOnDisk、および MergeTreeDataPart{Compact,Wide} オブジェクト自体)、テーブルのパーツ間で共有されるメタデータ (NamesAndTypesList、column_name_to_position、serializations map、および ColumnsSubstreams。SharedPartColumns.h を参照) に加え、テーブルごとのメタデータ (setProperties によって設定される StorageInMemoryMetadata / ColumnsDescription / VirtualColumnsDescription の clones、serialization_hints aggregation、shared_part_columns_cache) も含まれます。アクティブなパーツと、クリーンアップ待ちの outdated parts の両方がこの値に含まれます。cache アリーナおよび JIT アリーナとは別です。パーツごとのカラム system.parts.primary_key_bytes_in_memory[_allocated] と system.parts.index_granularity_bytes_in_memory[_allocated] は、このメトリクスの subset です (これらの値が 0 でない場合) 。プライマリインデックスは PrimaryIndexCache が所有している場合でもここで割り当てられます (パーツがすでに committed された後では、cache 境界での再配置に失敗する可能性があるため、意図的です) 。そのため、PrimaryIndexCacheBytes はこのメトリクスと重複します。

jemalloc.mergetree_arena.count

長期間保持されるMergeTreeメタデータ専用のjemallocアリーナ数。jemalloc_merge_tree_arenasサーバー設定で制御されます。0は専用アリーナプールが無効で、メタデータはCPUごとのデフォルトアリーナに割り当てられることを意味します。1は単一の共有アリーナ、N > 1はCPUごとに分片されたプールです。jemalloc.mergetree_arena.active_bytesを参照してください。

jemalloc.mergetree_arena.dirty_bytes

専用の jemalloc MergeTree アリーナプール全体で合計された、OS にパージして返却可能な、ダーティバイト数。

jemalloc.mergetree_arena.pactive

専用の jemalloc MergeTree アリーナプール内のアクティブページ数の合計。

jemalloc.mergetree_arena.pdirty

専用の jemalloc MergeTree アリーナプール内のダーティページ数の合計。

jemalloc.metadata

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。詳細は https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.metadata_thp

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。詳しくは https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.prof.active

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.prof.lg_sample

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.prof.thread_active_init

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.resident

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。詳細は https://jemalloc.net/jemalloc.3.html を参照してください。

jemalloc.retained

低レベルメモリアロケータ (jemalloc) の内部メトリクスです。詳しくは https://jemalloc.net/jemalloc.3.html を参照してください。

ジッター

非同期メトリクスを計算するスレッドについて、ウェイクアップが予定されていた時刻と、実際にウェイクアップした時刻との差。システム全体のレイテンシと応答性を間接的に示す指標です。

KeeperApproximateDataSize

ClickHouse Keeper のデータのおおよそのサイズ (バイト単位) 。

KeeperAvgLatency

ClickHouse Keeper の平均リクエストレイテンシ。

KeeperCommitLogsCacheEntries

changelog の先読み reader によって、commit thread の前方で現在 buffer されているデコード済みログエントリ数

KeeperCommitLogsCacheSize

changelogの先読みreaderによってcommit threadの前にbufferedされている、デコード済みログエントリの合計サイズ

KeeperEphemeralsCount

ClickHouse Keeper 内の一時ノード数。

KeeperFollowers

ClickHouse Keeper のフォロワー数です。

KeeperIsExceedingMemorySoftLimitHit

ClickHouse Keeper がメモリの soft limit を超過している場合は 1、そうでない場合は 0。

KeeperIsFollower

ClickHouse Keeper がフォロワーの場合は 1、そうでない場合は 0。

KeeperIsLeader

ClickHouse Keeper が leader であれば 1、それ以外は 0。

KeeperIsObserver

ClickHouse Keeper がオブザーバーの場合は 1、それ以外は 0。

KeeperIsStandalone

ClickHouse Keeper がスタンドアロンモードの場合は 1、それ以外は 0。

KeeperKeyArenaSize

ClickHouse Keeper におけるキー用メモリアリーナのサイズをバイト単位で表したものです。

KeeperLastCommittedLogIdx

ClickHouse Keeper における最後にコミット済みのログの索引。

KeeperLastLeaderElectionTime

この ClickHouse Keeper インスタンスがリーダーになった時点で終了した、ローカルで最後に観測されたリーダー不在期間 (ミリ秒) 。サンプリングされたリーダー不在状態が観測されないリーダー移行は記録されません。このインスタンスがアクティブなリーダーでない場合、または完了した期間が記録されていない場合は0。

KeeperLastLeaderUnavailableTime

このClickHouse Keeperリーダーがローカルで観測した、直近で完了したリーダー不在期間の継続時間 (ミリ秒) 。このインスタンスがアクティブなリーダーでない場合、または完了したリーダー不在期間が記録されていない場合は0。

KeeperLastLogIdx

ClickHouse Keeper に保存されている最新のログの索引。

KeeperLastLogTerm

ClickHouse Keeper に保存されている最後のログの Raft ターム。

KeeperLastSnapshotIdx

最後に作成されたスナップショットに含まれる最後のログの索引。

KeeperLatestLogsCacheEntries

最新ログ用のメモリ内cacheに格納されているエントリ数

KeeperLatestLogsCacheSize

最新ログのインメモリキャッシュの合計サイズ

KeeperLatestSnapshotSize

ClickHouse Keeper が作成した最新の snapshot の非圧縮サイズ (バイト単位) 。

KeeperMaxFileDescriptorCount

ClickHouse Keeper で開かれているファイルディスクリプタ数の上限。値を判別できない場合は -1。

KeeperMaxLatency

ClickHouse Keeper におけるリクエストの最大レイテンシ。

KeeperMinLatency

ClickHouse Keeper のリクエストレイテンシの最小値。

KeeperOpenFileDescriptorCount

ClickHouse Keeper で開いているファイルディスクリプタの数。値を特定できない場合は -1。

KeeperPacketsReceived

ClickHouse Keeperが受信したパケット数。

KeeperPacketsSent

ClickHouse Keeper が送信したパケット数。

KeeperPathsWatched

ClickHouse Keeper のクライアントが監視している異なるパスの数。

KeeperSessionWithWatches

ウォッチが設定されている ClickHouse Keeper のクライアントセッション数。

KeeperSyncedFollowers

同期が取れているClickHouse Keeperのfollowersの数。

KeeperTargetCommitLogIdx

ClickHouse Keeper でログをコミットできる最大の索引位置。

KeeperTCPRejectedConnections

Keeper TCP プロトコル (TLS なし) で拒否された接続の数。

KeeperTCPSecureRejectedConnections

Keeper TCP プロトコル (TLS 使用) で拒否された接続数。

KeeperTCPSecureThreads

Keeper TCP プロトコル (TLS 使用) のサーバーのスレッド数。

KeeperTCPThreads

Keeper TCP プロトコル (TLS なし) のサーバーのスレッド数。

KeeperWatchCount

ClickHouse Keeper 内のウォッチ数。

KeeperZnodeCount

ClickHouse Keeper 内にあるノード (データエントリ) の数。

KeeperZxid

ClickHouse Keeper における現在のトランザクション ID 番号 (zxid) 。

LoadAverage1

システム全体の負荷を、1 分間の指数平滑平均で表したものです。この負荷は、現在 CPU で実行中、I/O 待ち、または実行可能でありながらこの時点ではまだスケジュールされていない、全プロセスにまたがるスレッド数 (OS kernel のスケジューリングエンティティ) を表します。この数には、clickhouse-server だけでなく、すべてのプロセスが含まれます。システムが過負荷状態にあり、実行可能な多数のプロセスが CPU または I/O を待機している場合、この数は CPU コア数を上回ることがあります。

LoadAverage15

システム全体の負荷を、15 分間の指数平滑平均で表したものです。この負荷は、現在 CPU で実行中、I/O 待ち、または実行可能でありながらこの時点ではまだスケジュールされていない、全プロセスにまたがるスレッド数 (OS kernel のスケジューリングエンティティ) を表します。この数には、clickhouse-server だけでなく、すべてのプロセスが含まれます。システムが過負荷状態にあり、実行可能な多数のプロセスが CPU または I/O を待機している場合、この数は CPU コア数を上回ることがあります。

LoadAverage5

システム全体の負荷を、5 分間の指数平滑平均で表したものです。この負荷は、現在 CPU で実行中、I/O 待ち、または実行可能でありながらこの時点ではまだスケジュールされていない、全プロセスにまたがるスレッド数 (OS kernel のスケジューリングエンティティ) を表します。この数には、clickhouse-server だけでなく、すべてのプロセスが含まれます。システムが過負荷状態にあり、実行可能な多数のプロセスが CPU または I/O を待機している場合、この数は CPU コア数を上回ることがあります。

LongestRunningMerge

現在実行中のバックグラウンドマージのうち、最も長く実行されているものの経過時間 (秒) 。

MaxPartCountForPartition

MergeTree family のすべてのテーブルのすべてのパーティションを通じた、パーティションあたりのパーツ数の最大値です。300 を超える場合は、設定ミス、過負荷、または大量のデータ読み込みを示しています。

MemoryCode

サーバープロセスのマシンコードのページにマッピングされた仮想メモリ量 (バイト単位) 。

MemoryDataAndStack

スタック領域および割り当てられたメモリ用にマップされた仮想メモリの量を、バイト単位で示します。これに各スレッドのスタックや、mmap システムコールで割り当てられたメモリの大部分が含まれるかどうかは明確ではありません。このメトリクスは完全性を保つためだけに存在します。監視には MemoryResident メトリクスの使用を推奨します。

MemoryResident

サーバープロセスが使用している物理メモリ量 (バイト単位) 。

MemoryResidentMax

サーバープロセスが使用する物理メモリの最大量 (バイト単位) 。

MemoryResidentWithoutPageCache

サーバープロセスが使用する物理メモリ量を、ユーザー空間ページキャッシュを除いてバイト単位で示します。ユーザー空間ページキャッシュを使用している場合、これにより実際のメモリ使用量をより正確に把握できます。ユーザー空間ページキャッシュが無効な場合、この値は MemoryResident と同じになります。

MemoryShared

サーバープロセスが使用しているメモリのうち、他のプロセスとも共有されている分の容量を、バイト単位で示します。ClickHouse は共有メモリを使用しませんが、OS の都合でメモリの一部が共有として扱われることがあります。このメトリクスを監視してもあまり意味はなく、完全性のためだけに存在しています。

MemoryThreadStacksCount

/ proc/self/smaps 内で [anon:clickhouse_stack] とタグ付けされた pthread スタック VMA の数。heavy-metrics の更新間隔で更新されます。Linux 5.17 以降が必要です。古いカーネルでは利用できません (system.warnings の MEMORY_THREAD_STACKS_METRIC_UNAVAILABLE エントリを参照) 。 VM_MEMORY_STACK とタグ付けされたタスクの VM リージョン数 (アクセスできないガードリージョンを除く) 。heavy-metrics の更新間隔で更新されます。

MemoryThreadStacksResident

prctl(PR_SET_VMA_ANON_NAME) により [anon:clickhouse_stack] とタグ付けされた /proc/self/smaps VMA の Rss: を合計した、pthread スタックのおおよその常駐セットサイズです。heavy-metrics の周期で更新されます。Linux 5.17 以降が必要です。古いカーネルでは使用できません (system.warnings の MEMORY_THREAD_STACKS_METRIC_UNAVAILABLE エントリを参照) 。 VM_MEMORY_STACK とタグ付けされたタスクの VM リージョンの常駐ページ (アクセス不能なガードリージョンを除く) を合計した、pthread スタックのおおよその常駐セットサイズです。heavy-metrics の周期で更新されます。

MemoryThreadStacksVirtual

[anon:clickhouse_stack] とタグ付けされた /proc/self/smaps VMA の Size: の合計値である、pthread スタックの概算仮想サイズです。heavy-metrics の更新間隔で更新されます。Linux 5.17 以降が必要です。古いカーネルでは使用できません (system.warnings の MEMORY_THREAD_STACKS_METRIC_UNAVAILABLE エントリを参照) 。 VM_MEMORY_STACK とタグ付けされたタスクの VM リージョンのサイズの合計値である、pthread スタックの概算仮想サイズです (アクセスできないガードリージョンを除く) 。heavy-metrics の更新間隔で更新されます。

MemoryVirtual

サーバープロセスに割り当てられた仮想アドレス空間のサイズを、バイト単位で表します。仮想アドレス空間のサイズは通常、物理メモリの消費量よりはるかに大きく、メモリ消費量の見積もりには使うべきではありません。このメトリックの値が大きいことはまったく異常ではなく、技術的な意味合いしかありません。

MySQLRejectedConnections

MySQL互換プロトコルで拒否された接続数。

MySQLThreads

MySQL互換プロトコルのサーバーにおけるスレッド数。

NetworkReceiveBytes_interface_name

ネットワークインターフェイス経由で受信したバイト数。このメトリクスはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。

NetworkReceiveDrop_interface_name

ネットワークインターフェイス経由で受信した際に、パケットがドロップされたバイト数です。これはシステム全体のメトリックであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。

NetworkReceiveErrors_interface_name

ネットワークインターフェイス経由の受信時にエラーが発生した回数です。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。

NetworkReceivePackets_interface_name

ネットワークインターフェイス経由で受信したネットワークパケット数です。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが対象に含まれます。

NetworkSendBytes_interface_name

ネットワークインターフェイス経由で送信されたバイト数です。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。

NetworkSendDrop_interface_name

ネットワークインターフェイス経由での送信中に packed がドロップされた回数。これはシステム全体のメトリックで、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが対象です。

NetworkSendErrors_interface_name

ネットワークインターフェイス経由での送信中にエラー (例: TCP 再送) が発生した回数です。このメトリクスはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。

NetworkSendPackets_interface_name

ネットワークインターフェイス経由で送信されたネットワークパケット数です。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。

NetworkTCPReceiveQueue

サーバーで使用される TCPv4 および TCPv6 のネットワークソケットにおける受信キューの合計サイズ。

NetworkTCPSocketRemoteAddresses

サーバーで使用されるネットワークソケットの、TCPv4 および TCPv6 全体での一意なリモートアドレスの総数。

NetworkTCPSockets

サーバー上で使用されている、TCPv4 および TCPv6 の全状態にわたるネットワークソケットの総数。

NetworkTCPSockets_説明

TCPv4 と TCPv6 全体における、サーバー上で特定の状態にあるネットワークソケットの総数。

NetworkTCPTransmitQueue

サーバーで使用されるネットワークソケットの送信キューの合計サイズです。対象は TCPv4 と TCPv6 の両方です。

NetworkTCPUnrecoveredRetransmits

サーバーで使用されているネットワークソケットにおける、TCPv4 および TCPv6 全体の現在の再送信数 (この時点で未回復) の合計サイズ。

NumberOfDatabases

サーバー上にあるデータベースの総数。

NumberOfDetachedByUserParts

ユーザーが ALTER TABLE DETACH クエリを使用して MergeTree テーブルからデタッチしたパーツの総数です (予期しないパーツ、破損したパーツ、無視されたパーツは含みません) 。サーバーはデタッチされたパーツを考慮しないため、これらは削除できます。

NumberOfDetachedParts

MergeTree テーブルからデタッチされたパーツの総数です。パーツは、ユーザーが ALTER TABLE DETACH クエリでデタッチすることも、パーツが破損している、Unexpected である、または不要な場合に、サーバー自身によってデタッチされることもあります。サーバーはデタッチされたパーツを管理対象として扱わないため、それらは削除できます。

NumberOfPendingMutations

変異処理の適用待ちとなっているミューテーションの総数です。

指定した実行時間を超えて保留中のミューテーション数

指定した max_pending_mutations_execution_time_to_warn 設定値を超えており、なおミューテーションが適用されていないデータパートを含むミューテーションの総数。

NumberOfTables

Lazy、MySQL、PostgreSQL、SQlite のように、その場でテーブルの集合を動的に生成するデータベースエンジンなど、MergeTree テーブルを含められないデータベースを除いた、サーバー上の各データベースにまたがるテーブル総数です。

NumberOfTablesSystem

サーバー上の system データベースで、MergeTree family のテーブルに格納されているテーブルの総数。

OSContextSwitches

ホストマシン上でシステムに発生したコンテキストスイッチの回数です。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが対象です。

OSCPUOverload

相対的なCPU不足を表し、次のように計算されます。CPUを使用しているスレッド数に対して、CPU待ちのスレッドがどれだけあるかを示します。これがゼロより大きい場合、サーバーにはより多くのCPUがあると有利です。これがゼロを大幅に上回る場合、サーバーが応答しなくなる可能性があります。このメトリクスは、非同期メトリクスの更新の間に蓄積されます。

OSGuestNiceTimecpu_suffix

Linux カーネルの管理下で、ゲストの優先度が高く設定されているときに、ゲスト OS 用の仮想 CPU の実行に費やされた時間の比率です (man procfs を参照) 。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。このメトリクスは ClickHouse では意味を持ちませんが、網羅性のために存在します。単一の CPU コアの値は区間 [0..1] になります。すべての CPU コアの値は、それらの合計として [0..num cores] の範囲で計算されます。

OSGuestNiceTimeNormalized

この値は OSGuestNiceTime と似ていますが、CPU コア数に関係なく [0..1] の範囲で測定できるよう、CPU コア数で割られています。これにより、CPU コア数が均一でない場合でも、クラスター内の複数のサーバーにわたってこのメトリクスの値を平均し、平均的なリソース使用状況を表すメトリクスを得ることができます。指定されている場合は、実際の CPU コア数の代わりに、period で割った Cgroup CPU QUOTA を使用できます。その場合、このメトリクスの値は一時的に 1 を超えることがあります。

OSGuestTimecpu_suffix

Linux カーネルの制御下で、ゲスト OS 向けの仮想 CPU の実行に費やされた時間の比率です (man procfs を参照) 。これはシステム全体のメトリックであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。このメトリックは ClickHouse には関係ありませんが、完全性のために存在しています。単一の CPU コアの値は区間 [0..1] です。すべての CPU コアの値は、それらの合計として [0..num cores] になります。

OSGuestTimeNormalized

この値は OSGuestTime に似ていますが、コア数にかかわらず [0..1] の範囲で表せるよう、CPU コア数で割って正規化されています。これにより、コア数が均一でない場合でも、クラスター内の複数のサーバーにまたがってこのメトリクスの値を平均し、平均的なリソース使用状況を表すメトリクスを得ることができます。指定した場合は、実際の CPU コア数の代わりに、Cgroup CPU QUOTA をその期間で割った値を使用できます。その場合、このメトリクスの値が一時的に 1 を超えることがあります。

OSIdleTimecpu_suffix

OS カーネルから見て、CPU コアがアイドル状態だった時間の比率です (I/O 待ちのプロセスを実行する準備すらできていない状態) 。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。これには、CPU 内部の要因 (メモリロード、パイプラインストール、ブランチ予測ミス、別の SMT コアの実行) によって CPU を十分に使い切れていなかった時間は含まれません。単一の CPU コアの値は [0..1] の範囲になります。すべての CPU コアの値は、それらの合計として [0..num cores] の範囲で計算されます。

OSIdleTimeNormalized

この値は OSIdleTime に似ていますが、CPU コア数に関係なく [0..1] の範囲で表せるように、CPU コア数で割って正規化したものです。これにより、CPU コア数が均一でない場合でも、クラスター内の複数のサーバーにまたがってこのメトリックの値を平均化し、平均的なリソース使用状況のメトリックを得ることができます。指定した場合は、実際の CPU コア数の代わりに、period で割った Cgroup CPU QUOTA を使用できます。この場合、このメトリックの値が一時的に 1 を超えることがあります。

OSInterrupts

ホストマシンで発生した割り込みの回数です。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが対象に含まれます。

OSIOWaitTimecpu_suffix

プロセスが I/O を待機しているため、CPU コアがコードを実行しておらず、かつ OS カーネルもこの CPU 上でほかのプロセスを実行していなかった時間の比率です。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。単一の CPU コアの値は区間 [0..1] に収まります。すべての CPU コアの値は、それらの合計として [0..num cores] の範囲で計算されます。

OSIOWaitTimeNormalized

この値は OSIOWaitTime と似ていますが、コア数に関係なく [0..1] の範囲で表せるよう、CPU コア数で割って正規化したものです。これにより、クラスター内の複数のサーバーで CPU コア数が均一でない場合でも、このメトリクスの値を平均して、平均的なリソース使用状況を表すメトリクスを得ることができます。指定した場合は、実際の CPU コア数の代わりに、Cgroup CPU QUOTA をその period で割った値を使用できます。その場合、このメトリクスの値が一時的に 1 を超えることがあります。

OSIrqTimecpu_suffix

CPU 上でハードウェア割り込み要求の処理に費やされた時間の比率です。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。このメトリクスの値が高い場合は、ハードウェア構成の不備やネットワーク負荷が非常に高いことを示している可能性があります。単一の CPU コアの値は [0..1] の範囲になります。すべての CPU コアの値は、各コアの合計として [0..num cores] の範囲で計算されます。

OSIrqTimeNormalized

この値は OSIrqTime に似ていますが、コア数にかかわらず [0..1] の範囲で表せるよう、CPU コア数で割って正規化されています。これにより、クラスター内の複数のサーバーでコア数が均一でない場合でも、このメトリクスの値を平均して、平均的なリソース使用状況のメトリクスを得ることができます。指定されている場合は、実際の CPU コア数の代わりに、Cgroup CPU QUOTA をその period で割った値を使用できます。その場合、このメトリクスの値が一時的に 1 を超えることがあります。

OSMemoryAvailable

プログラムが使用できるメモリ量を、バイト単位で表したものです。これは OSMemoryFreePlusCached メトリクスと非常によく似ています。システム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。

OSMemoryBuffers

OS カーネルのバッファで使用されているメモリ量を、バイト単位で示します。通常、この値は小さいはずで、値が大きい場合は OS の設定不備を示している可能性があります。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。

OSMemoryCached

OS page cacheが使用しているメモリ量を、バイト単位で示します。通常、利用可能なメモリのほぼすべてがOSページキャッシュに使用されるため、このメトリクスの値が高いのは正常であり、想定内です。これはホストマシン全体を対象とするメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。

OSMemoryFreePlusCached

ホストシステム上の空きメモリ量と OS page cache のメモリ量の合計を、バイト単位で示します。このメモリはプログラムで使用可能です。この値は OSMemoryAvailable と非常に近いはずです。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。

OSMemoryFreeWithoutCached

ホストシステム上の空きメモリ量を、バイト単位で示します。これには、OS page cache が使用しているメモリ量は含まれません (単位はバイト) 。page cache のメモリもプログラムで利用できるため、このメトリクスの値は分かりにくいことがあります。代わりに OSMemoryAvailable メトリクスを参照してください。便宜上、OSMemoryFreePlusCached メトリクスも提供しており、これは OSMemoryAvailable とある程度似た値になります。あわせて https://www.linuxatemyram.com/ も参照してください。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。

OSMemorySwapCached

スワップにあり、かつ RAM にも読み込まれていたメモリ量です。スワップは本番環境のシステムでは無効にする必要があります。このメトリックの値が大きい場合、設定ミスを示しています。これはシステム全体のメトリックであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。

OSMemoryTotal

ホストシステムのメモリ総量 (バイト単位) 。

OSNiceTimecpu_suffix

CPU コアが、より高い優先度のユーザー空間のコードを実行していた時間の比率です。これはシステム全体のメトリックであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。単一の CPU コアの値は [0..1] の範囲になります。すべての CPU コアの値は、それらの合計として [0..num cores] の範囲で計算されます。

OSNiceTimeNormalized

この値は OSNiceTime と似ていますが、CPU コア数で割ることで、コア数にかかわらず [0..1] の範囲で表されます。これにより、コア数が均一でない場合でも、クラスター内の複数のサーバーにまたがってこのメトリクスの値を平均し、平均的なリソース使用状況を表すメトリクスを得ることができます。指定した場合は、実際の CPU コア数の代わりに、Cgroup CPU QUOTA をその period で割った値を使用できます。その場合、このメトリクスの値が一時的に 1 を超えることがあります。

OSOpenFiles

ホストマシン上で開いているファイルの総数です。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスで開かれているファイルが含まれます。

OSProcessesBlocked

I/O の完了待ちでブロックされているスレッド数です (man procfs) 。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。

作成された OS プロセス数

作成されたプロセスの数です。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。

OSProcessesRunning

オペレーティングシステムにおける、実行可能な (実行中または実行待ちの) スレッド数です。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。

OSSoftIrqTimecpu_suffix

CPU でソフトウェア割り込み要求の処理に費やされた時間の比率です。これはシステム全体のメトリックであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。このメトリックの値が高い場合は、システム上で動作しているソフトウェアが非効率である可能性があります。単一の CPU コアの値は [0..1] の範囲に収まります。すべての CPU コアの値は、各コアの値を合計した [0..num cores] として計算されます。

OSSoftIrqTimeNormalized

この値は OSSoftIrqTime に似ていますが、コア数にかかわらず [0..1] の範囲で表せるよう、CPU コア数で割って正規化されています。これにより、クラスター内の複数のサーバーでコア数が揃っていない場合でも、このメトリクスの値を平均し、平均的なリソース使用状況を表すメトリクスを得ることができます。指定されている場合は、実際の CPU コア数の代わりに、Cgroup CPU QUOTA をその period で割った値を使用することもでき、その場合、このメトリクスの値が一時的に 1 を超えることがあります。

OSStealTimecpu_suffix

仮想化環境で実行されているときに、CPU が他のオペレーティングシステムの実行に費やした時間の比率です。これはシステム全体のメトリックであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。すべての仮想化環境でこのメトリックが利用できるわけではなく、実際にはほとんどの環境で利用できません。単一の CPU コアの値は区間 [0..1] になります。すべての CPU コアの値は、各コアの合計として [0..num cores] の範囲で計算されます。

OSStealTimeNormalized

この値は OSStealTime に似ていますが、CPU コア数で割ることで、コア数にかかわらず [0..1] の範囲に収まるよう正規化されています。これにより、クラスター内の複数のサーバーでこのメトリックの値を平均する際、コア数が均一でなくても、平均的なリソース使用状況を表すメトリックとして扱えます。指定されている場合は、実際の CPU コア数の代わりに、Cgroup の CPU QUOTA をその period で割った値を使用できます。その場合、このメトリックの値が一時的に 1 を超えることがあります。

OSSystemTimecpu_suffix

CPU コアが OS カーネル (system) コードを実行していた時間の比率です。これはシステム全体のメトリックであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。単一の CPU コアの値は [0..1] の範囲になります。すべての CPU コアの値は、それらの合計として [0..num cores] の範囲で計算されます。

OSSystemTimeNormalized

この値は OSSystemTime と似ていますが、CPU コア数で割ることで、コア数にかかわらず [0..1] の範囲に収まるようになっています。これにより、クラスター内の複数のサーバーでコア数が均一でない場合でも、このメトリクスの値を平均化し、平均的なリソース使用状況のメトリクスを得ることができます。指定した場合は、実際の CPU コア数の代わりに、Cgroup CPU QUOTA をその period で割った値を使用できます。その場合、このメトリクスの値が一時的に 1 を超えることがあります。

OSThreadsRunnable

OSカーネルのスケジューラから見て、「実行可能」状態にあるスレッドの総数。

OSThreadsTotal

OSカーネルのスケジューラから見たスレッドの総数です。

OSUptime

ホストサーバー (ClickHouse が稼働しているマシン) の稼働時間 (秒単位) 。

OSUserTimecpu_suffix

CPU コアがユーザー空間のコードを実行していた時間の割合です。これはシステム全体のメトリクスであり、clickhouse-server だけでなく、ホストマシン上のすべてのプロセスが含まれます。また、CPU 内部の要因 (メモリロード、パイプラインのストール、ブランチ予測ミス、別の SMT コアの実行) によって CPU が十分に活用されていなかった時間も含まれます。単一の CPU コアの値は区間 [0..1] です。すべての CPU コアの値は、各コアの合計として [0..num cores] の範囲で計算されます。

OSUserTimeNormalized

この値は OSUserTime と似ていますが、CPU コア数に関係なく [0..1] の範囲で測定できるよう、CPU コア数で割ってあります。これにより、コア数が一様でない場合でも、クラスター内の複数のサーバーにまたがってこのメトリクスの値を平均し、平均的なリソース使用状況のメトリクスを得ることができます。指定されている場合は、実際の CPU コア数の代わりに、Cgroup CPU QUOTA をその period で割った値を使用できます。その場合、このメトリクスの値が一時的に 1 を超えることがあります。

PageCacheMaxBytes

ユーザー空間ページキャッシュの現在のサイズ上限 (バイト単位) 。

PostgreSQLRejectedConnections

PostgreSQL互換プロトコルで拒否された接続数。

PostgreSQLThreads

PostgreSQL互換プロトコルのサーバー内のスレッド数。

ProcessSignalQueueLimit

シグナルキューの総上限 (ProcessSignalQueueSize に達すると、CANNOT_CREATE_TIMER エラーが発生することがあります)

ProcessSignalQueueSize

シグナルキューのサイズ (処理待ちのシグナル、クエリプロファイリング用タイマー)

PrometheusRejectedConnections

Prometheus エンドポイントで拒否された接続数。注: Prometheus エンドポイントは、通常の HTTP/HTTPS ポート経由でも使用できます。

PrometheusThreads

Prometheus エンドポイントのサーバー内のスレッド数。注: Prometheus エンドポイントは、通常の HTTP/HTTPS ポート経由でも使用できます。

PSI_type_stall_type

前回の測定以降のストール時間をマイクロ秒単位で表した値です。メトリクスとその解釈方法については、アップストリームのドキュメント https://docs.kernel.org/accounting/psi.html を参照してください

QueriesMemoryUsage

サーバー上で現在実行中のすべてのクエリが使用しているメモリの総量です (単位: バイト) 。同時実行中のクエリ負荷によるメモリ逼迫を特定するのに役立ちます。

QueriesPeakMemoryUsage

ProcessList で追跡されている全ユーザーについて、ユーザーごとのクエリメモリ使用量のピーク値を合計したものです。単位はバイトです。各ユーザーのピーク値は、そのユーザーの memory tracker の最高水位であり、そのユーザーに実行中のクエリがなくなるとリセットされます。したがって、これは現在追跡されているユーザーごとのピーク値の集計であり、起動以降のすべてのクエリにおける server 全体の単一のピーク値ではありません。

ReaderExecutorModeledCostMsPerRequestedMiB

Experimental ReaderExecutor の読み取りパス効率: 直近の更新間隔における、リクエストされたバイト数 MiB あたりの推定コスト (ms) 。インスタンス全体での ProfileEvents ReaderExecutorModeledCostMicroseconds と ReaderExecutorDeliveredBytes の差分の比です。低いほど良好です。帯域幅の下限は約 20 (正常なソースからの読み取り) で、cache ヒットでは 0 に近づき、過剰フェッチや不完全な connections により値が増加します。0 は、その間隔に executor による読み取りがなかったことを示します。

ReplicasMaxAbsoluteDelay

レプリケートテーブル全体において、最新のレプリケート済みパートと、まだレプリケートされていない最新のデータパートとの最大の遅延 (秒) です。この値が非常に大きい場合は、データを持たないレプリカが存在することを示します。

ReplicasMaxInsertsInQueue

レプリケートテーブル全体で、キュー内にある INSERT 操作 (まだレプリケートされていないもの) の最大数。

ReplicasMaxMergesInQueue

レプリケートテーブル全体で、キュー内にある未適用のマージ操作の最大数。

ReplicasMaxQueueSize

レプリケートテーブル全体での最大キューサイズ (get や merge などの操作数) 。

ReplicasMaxRelativeDelay

レプリケートテーブル全体における、あるレプリカの遅延と、同じテーブルで最も最新のレプリカの遅延との差の最大値。

ReplicasSumInsertsInQueue

レプリケートテーブル全体で、キュー内にある INSERT 操作 (まだレプリケートされていないもの) の合計。

ReplicasSumMergesInQueue

レプリケートテーブル全体で、キュー内にあるマージ操作 (まだ適用されていないもの) の合計。

ReplicasSumQueueSize

レプリケートテーブル全体における、get や merge などの操作数で表したキューサイズの合計。

TCPRejectedConnections

TLS を使用しない TCP プロトコルで拒否された接続数。

TCPSecureRejectedConnections

TCPプロトコル (TLS 使用) の拒否された接続数

TCPSecureThreads

TLS を使用する TCP プロトコルのサーバーにおけるスレッド数。

TCPThreads

TLS を使用しない TCP プロトコルのサーバーにおけるスレッド数。

温度i

対応するデバイスの温度 (℃) です。センサーが現実的ではない値を返すことがあります。取得元: /sys/class/thermal

温度_hwmon_name

対応するハードウェアモニターが報告する温度 (℃) です。センサーが現実的でない値を返すことがあります。取得元: /sys/class/hwmon

温度_hwmon_name_sensor_name

対応するハードウェアモニターおよびセンサーが報告する温度 (℃) です。センサーが現実的でない値を返すことがあります。取得元: /sys/class/hwmon

MergeTree family テーブルの総バイト数

MergeTree family のすべてのテーブルに格納されている合計バイト数 (圧縮後、データとインデックスを含む) 。

TotalBytesOfMergeTreeTablesSystem

system データベース内の MergeTree family のテーブルに格納されているバイト総数 (圧縮後の値で、データとインデックスを含む) 。

TotalIndexGranularityBytesInMemory

インデックスグラニュールで使用されるメモリの総量 (バイト単位。アクティブなパーツのみを対象) 。

TotalIndexGranularityBytesInMemoryAllocated

インデックスグラニュール用に確保されたメモリの総量 (バイト単位。アクティブなパーツのみを対象) 。

TotalPartsOfMergeTreeTables

MergeTree family のすべてのテーブルにおけるデータパーツの総数です。10 000 を超える数値はサーバーの起動時間に悪影響を及ぼすほか、パーティションキーの選択が不適切である可能性があります。

TotalPartsOfMergeTreeTablesSystem

system データベース内の MergeTree family のテーブルにおけるデータパーツの総数です。

TotalPrimaryKeyBytesInMemory

主キー値が使用するメモリの総量 (バイト単位、アクティブなパーツのみを対象) 。

TotalPrimaryKeyBytesInMemoryAllocated

主キー値用に予約されているメモリの総量 (バイト単位、アクティブなパーツのみを対象) 。

TotalProjectionIndexGranularityBytesInMemory

プロジェクションのインデックス粒度が使用するメモリの総量 (バイト単位、アクティブなパーツのみを対象) 。

TotalProjectionIndexGranularityBytesInMemoryAllocated

プロジェクションのインデックス粒度用に予約されたメモリの総量 (バイト単位) 。アクティブなパーツのみを対象とします。

TotalProjectionPrimaryKeyBytesInMemory

プロジェクションの主キー値で使用されるメモリの総量 (バイト単位、アクティブなパーツのみを対象) 。

TotalProjectionPrimaryKeyBytesInMemoryAllocated

プロジェクションの主キー値のために確保されたメモリの総量 (バイト単位、アクティブなパーツのみを対象) 。

TotalRowsOfMergeTreeTables

MergeTree family のすべてのテーブルに格納されている行 (レコード) の総数。

TotalRowsOfMergeTreeTablesSystem

systemデータベース内のMergeTree familyのテーブルに格納されている行 (レコード) の総数。

TotalUncompressedBytesOfMergeTreeTables

MergeTree family のすべてのテーブルに格納されている、パーツのチェックサムで報告される非圧縮バイト数の総量です。system.tables の total_bytes_uncompressed カラムと同じ値を元にしており、marks や主キーインデックスなど、非圧縮で保存されるファイルは含まれません。

TotalUncompressedBytesOfMergeTreeTablesSystem

システムデータベース内の MergeTree family のテーブルに格納されている、パーツのチェックサムで報告される非圧縮バイトの総量です。これは system.tables の total_bytes_uncompressed カラムと同じ情報源であり、マークや主キーインデックスなど、非圧縮のまま保存されるファイルは含まれません。

TrackedMemory

ClickHouse が追跡しているメモリ量 (MemoryTracking メトリックと同じ値になるはず) で、単位はバイトです。

UntrackedMemory

TrackedMemory にまだ反映されていない、直近のメモリ割り当ておよび解放に関するスレッドごとのバッファの合計。

稼働時間

サーバーの稼働時間 (秒) 。接続を受け付ける前のサーバー初期化にかかった時間も含まれます。

VMMaxMapCount

プロセスが保持できるメモリマッピングの最大数 (/proc/sys/vm/max_map_count) 。

VMNumMaps

プロセスの現在のメモリマッピング数です (/proc/self/maps) 。最大値 (VMMaxMapCount) に近い場合は、/etc/sysctl.conf の vm.max_map_count の上限を引き上げる必要があります

ZooKeeperClientLastZXIDSeen

現在の ZooKeeper クライアントセッションが最後に確認した ZXID です。この値は、クライアントが ZooKeeper のトランザクションを観測するたびに単調に増加します。 関連項目

監視 — ClickHouse の監視に関する基本概念。
system.metrics — 即時に計算されるメトリクスが含まれます。
system.events — 発生した各種イベントが含まれます。
system.metric_log — system.metrics および system.events テーブルのメトリクス値の履歴が含まれます。

最終更新日 2026年8月18日

​説明

​カラム

​例

​メトリクスの説明

​nameDeadBlobsQueueEstimate

​nameMissingBlobsQueueEstimate

​AsynchronousHeavyMetricsCalculationTimeSpent

​AsynchronousHeavyMetricsUpdateInterval

​AsynchronousMetricsCalculationTimeSpent

​AsynchronousMetricsUpdateInterval

​AsyncLoggingmetric_firstQueueSize

​BlockActiveTime_name

​BlockActiveTimePerOp_name

​BlockDiscardBytes_name

​BlockDiscardMerges_name

​BlockDiscardOps_name

​BlockDiscardTime_name

​BlockInFlightOps_name

​BlockQueueTime_name

​BlockQueueTimePerOp_name

​BlockReadBytes_name

​BlockReadMerges_name

​BlockReadOps_name

​BlockReadTime_name

​BlockWriteBytes_name

​BlockWriteMerges_name

​BlockWriteOps_name

​BlockWriteTime_name

​CGroupMaxCPU

​CGroupMemoryTotal

​CGroupMemoryUsed

​CGroupMemoryUsedWithoutPageCache

​CGroupSystemTime

​CGroupSystemTimeNormalized

​CGroupUserTime

​CGroupUserTimeNormalized

​CompiledExpressionCacheBytesMax

​CompiledExpressionCacheCountMax

​CPUFrequencyMHz_core_id

​DictionaryMaxUpdateDelay

​DictionaryTotalFailedUpdates

​DiskAvailable_name

​DiskGetObjectThrottlerAvailable_name

​DiskGetObjectThrottlerRPS_name

​DiskPutObjectThrottlerAvailable_name

​DiskPutObjectThrottlerRPS_name

​DiskTotal_name

​DiskUnreserved_name

​DiskUsed_name

​EDACi_Correctable

​EDACi_Uncorrectable

​ExecutableUserDefinedFunctionMemoryResidentBytes

​ExecutableUserDefinedFunctionProcesses

​FilesystemCacheBytes

​FilesystemCacheCapacity

​FilesystemCacheFiles

​FilesystemLogsPathAvailableBytes

​FilesystemLogsPathAvailableINodes

​FilesystemLogsPathTotalBytes

​FilesystemLogsPathTotalINodes

​FilesystemLogsPathUsedBytes

​FilesystemLogsPathUsedINodes

​FilesystemMainPathAvailableBytes

​FilesystemMainPathAvailableINodes

​FilesystemMainPathTotalBytes

​FilesystemMainPathTotalINodes

​FilesystemMainPathUsedBytes

​メインのClickHouseパスがマウントされているボリュームで使用中のinode数

​GRPCRejectedConnections

​GRPCThreads

​HashTableStatsCacheEntries

​HashTableStatsCacheHits

​HashTableStatsCacheMisses

​HTTPConnectionPoolgroup_nameTCPRcvBufTotalBytes

​HTTPConnectionPoolgroup_nameTCPSndBufTotalBytes

​HTTPRejectedConnections

​HTTPSecureRejectedConnections

​HTTPSecureThreads

​HTTPThreads

​InterserverRejectedConnections

説明

カラム

例

メトリクスの説明

nameDeadBlobsQueueEstimate

nameMissingBlobsQueueEstimate

AsynchronousHeavyMetricsCalculationTimeSpent

AsynchronousHeavyMetricsUpdateInterval

AsynchronousMetricsCalculationTimeSpent

AsynchronousMetricsUpdateInterval

AsyncLoggingmetric_firstQueueSize

BlockActiveTime_name

BlockActiveTimePerOp_name

BlockDiscardBytes_name

BlockDiscardMerges_name

BlockDiscardOps_name

BlockDiscardTime_name

BlockInFlightOps_name

BlockQueueTime_name

BlockQueueTimePerOp_name

BlockReadBytes_name

BlockReadMerges_name

BlockReadOps_name

BlockReadTime_name

BlockWriteBytes_name

BlockWriteMerges_name

BlockWriteOps_name

BlockWriteTime_name

CGroupMaxCPU

CGroupMemoryTotal

CGroupMemoryUsed

CGroupMemoryUsedWithoutPageCache

CGroupSystemTime

CGroupSystemTimeNormalized

CGroupUserTime

CGroupUserTimeNormalized

CompiledExpressionCacheBytesMax

CompiledExpressionCacheCountMax

CPUFrequencyMHz_core_id

DictionaryMaxUpdateDelay

DictionaryTotalFailedUpdates

DiskAvailable_name

DiskGetObjectThrottlerAvailable_name

DiskGetObjectThrottlerRPS_name

DiskPutObjectThrottlerAvailable_name

DiskPutObjectThrottlerRPS_name

DiskTotal_name

DiskUnreserved_name

DiskUsed_name

EDACi_Correctable

EDACi_Uncorrectable

ExecutableUserDefinedFunctionMemoryResidentBytes

ExecutableUserDefinedFunctionProcesses

FilesystemCacheBytes

FilesystemCacheCapacity

FilesystemCacheFiles

FilesystemLogsPathAvailableBytes

FilesystemLogsPathAvailableINodes

FilesystemLogsPathTotalBytes

FilesystemLogsPathTotalINodes

FilesystemLogsPathUsedBytes

FilesystemLogsPathUsedINodes

FilesystemMainPathAvailableBytes

FilesystemMainPathAvailableINodes

FilesystemMainPathTotalBytes

FilesystemMainPathTotalINodes

FilesystemMainPathUsedBytes

メインのClickHouseパスがマウントされているボリュームで使用中のinode数

GRPCRejectedConnections

GRPCThreads

HashTableStatsCacheEntries

HashTableStatsCacheHits

HashTableStatsCacheMisses

HTTPConnectionPoolgroup_nameTCPRcvBufTotalBytes

HTTPConnectionPoolgroup_nameTCPSndBufTotalBytes

HTTPRejectedConnections

HTTPSecureRejectedConnections

HTTPSecureThreads

HTTPThreads

InterserverRejectedConnections