system.asynchronous_metrics

バックグラウンドで定期的に計算されるメトリクスを格納するシステムテーブルです。たとえば、使用中のRAM量などが含まれます。

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.                                                                                                                                                                   │
└─────────────────────────────────────────┴────────────┴────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

​

メトリクスの説明

​

AsynchronousHeavyMetricsCalculationTimeSpent

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

​

AsynchronousHeavyMetricsUpdateInterval

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

​

AsynchronousMetricsCalculationTimeSpent

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

​

AsynchronousMetricsUpdateInterval

メトリクス更新間隔

​

BlockActiveTime_name

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

​

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 を参照してください

​

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 を参照してください。

​

CPUFrequencyMHz_name

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

​

DictionaryMaxUpdateDelay

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

​

DictionaryTotalFailedUpdates

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

​

DiskAvailable_name

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

​

DiskTotal_name

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

​

DiskUnreserved_name

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

​

DiskUsed_name

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

​

FilesystemCacheBytes

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の数です。通常、この値はファイル数にほぼ対応します。

​

HTTPThreads

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

​

HTTPSecureThreads

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

​

InterserverThreads

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

​

InterserverSecureThreads

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

​

ジッター

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

​

LoadAverageN

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

​

MaxPartCountForPartition

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

​

MemoryCode

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

​

MemoryDataAndStack

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

​

MemoryResidentMax

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

​

MemoryResident

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

​

MemoryShared

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

​

MemoryVirtual

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

​

MySQLThreads

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

​

NetworkReceiveBytes_name

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

​

NetworkReceiveDrop_name

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

​

NetworkReceiveErrors_name

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

​

NetworkReceivePackets_name

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

​

NetworkSendBytes_name

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

​

NetworkSendDrop_name

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

​

NetworkSendErrors_name

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

​

NetworkSendPackets_name

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

​

NumberOfDatabases

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

​

NumberOfDetachedByUserParts

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

​

NumberOfDetachedParts

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

​

NumberOfTables

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

​

OSContextSwitches

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

​

OSGuestNiceTime

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

​

OSGuestNiceTimeCPU_N

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 を超えることがあります。

​

OSGuestTime

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

​

OSGuestTimeCPU_N

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 を超えることがあります。

​

OSIOWaitTime

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

​

OSIOWaitTimeCPU_N

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

​

OSIOWaitTimeNormalized

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

​

OSIdleTime

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

​

OSIdleTimeCPU_N

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 だけでなく、ホストマシン上のすべてのプロセスが対象に含まれます。

​

OSIrqTime

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

​

OSIrqTimeCPU_N

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 だけでなく、ホストマシン上のすべてのプロセスが含まれます。

​

OSMemoryTotal

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

​

OSNiceTime

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

​

OSNiceTimeCPU_N

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 だけでなく、ホストマシン上のすべてのプロセスが含まれます。

​

OSSoftIrqTime

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

​

OSSoftIrqTimeCPU_N

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

​

OSSoftIrqTimeNormalized

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

​

OSStealTime

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

​

OSStealTimeCPU_N

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

​

OSStealTimeNormalized

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

​

OSSystemTime

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

​

OSSystemTimeCPU_N

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 が稼働しているマシン) の稼働時間 (秒単位) 。

​

OSUserTime

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

​

OSUserTimeCPU_N

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 を超えることがあります。

​

PostgreSQLThreads

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

​

QueriesMemoryUsage

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

​

QueriesPeakMemoryUsage

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

​

ReplicasMaxAbsoluteDelay

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

​

ReplicasMaxInsertsInQueue

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

​

ReplicasMaxMergesInQueue

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

​

ReplicasMaxQueueSize

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

​

ReplicasMaxRelativeDelay

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

​

ReplicasSumInsertsInQueue

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

​

ReplicasSumMergesInQueue

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

​

ReplicasSumQueueSize

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

​

TCPThreads

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

​

TCPSecureThreads

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

​

GRPCThreads

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

​

PrometheusThreads

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

​

KeeperTCPThreads

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

​

KeeperTCPSecureThreads

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

​

温度_N

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

​

温度_name

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

​

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

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

​

TotalPartsOfMergeTreeTables

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

​

TotalPrimaryKeyBytesInMemory

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

​

TotalPrimaryKeyBytesInMemoryAllocated

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

​

TotalRowsOfMergeTreeTables

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

​

稼働時間

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

​

ZooKeeperClientLastZXIDSeen

現在のZooKeeperクライアントセッションで最後に確認されたZXIDです。この値は、クライアントがZooKeeperからのトランザクションを観測するにつれて単調に増加します。

​

LongestRunningMerge

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

​

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

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

​

jemalloc.mapped

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

​

jemalloc.metadata

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

​

jemalloc.metadata_thp

低レベルメモリアロケータ (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 を参照してください。

​

jemalloc.prof.active

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

関連項目

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