メインコンテンツへスキップ
メインコンテンツへスキップ

system.metrics

ClickHouse Cloud でのクエリ実行

このシステムテーブルのデータは、ClickHouse Cloud の各ノードにローカルに格納されています。そのため、すべてのデータを包括的に確認するには、clusterAllReplicas 関数を使用する必要があります。詳細についてはこちらを参照してください。

即時に算出できるメトリクス、または現在値を持つメトリクスを含みます。例えば、同時に処理されているクエリ数や現在のレプリカ遅延などです。このテーブルは常に最新の値を反映します。

列:

  • metric (String) — メトリック名。
  • value (Int64) — メトリックの値。
  • description (String) — メトリックの説明。

サポートされているすべてのメトリクスの一覧は、src/Common/CurrentMetrics.cpp で確認できます。

例

SELECT * FROM system.metrics LIMIT 10

┌─metric───────────────────────────────┬─value─┬─description────────────────────────────────────────────────────────────┐
│ Query                                │     1 │ 実行中のクエリ数                                                       │
│ Merge                                │     0 │ 実行中のバックグラウンドマージ数                                       │
│ PartMutation                         │     0 │ ミューテーション数(ALTER DELETE/UPDATE)                                │
│ ReplicatedFetch                      │     0 │ レプリカから取得中のデータパーツ数                                     │
│ ReplicatedSend                       │     0 │ レプリカへ送信中のデータパーツ数                                       │
│ ReplicatedChecks                     │     0 │ 整合性チェック中のデータパーツ数                                       │
│ BackgroundMergesAndMutationsPoolTask │     0 │ 関連バックグラウンドプール内のアクティブなマージとミューテーション数   │
│ BackgroundFetchesPoolTask            │     0 │ 関連バックグラウンドプール内のアクティブなフェッチ数                   │
│ BackgroundCommonPoolTask             │     0 │ 関連バックグラウンドプール内のアクティブなタスク数                     │
│ BackgroundMovePoolTask               │     0 │ BackgroundProcessingPool内の移動用アクティブタスク数                  │
└──────────────────────────────────────┴───────┴────────────────────────────────────────────────────────────────────────┘

メトリクスの説明​

AggregatorThreads​

Aggregator スレッドプール内のスレッド数。

AggregatorThreadsActive​

タスクを実行中の Aggregator スレッドプール内のスレッド数。

TablesLoaderForegroundThreads​

非同期ローダーのフォアグラウンドスレッドプール内のスレッド数。

TablesLoaderForegroundThreadsActive​

タスクを実行中の非同期ローダーのフォアグラウンドスレッドプール内のスレッド数。

TablesLoaderBackgroundThreads​

非同期ローダーのバックグラウンドスレッドプール内のスレッド数。

TablesLoaderBackgroundThreadsActive​

タスクを実行中の非同期ローダーのバックグラウンドスレッドプール内のスレッド数。

AsyncInsertCacheSize​

キャッシュ内の非同期挿入ハッシュ ID の数。

AsynchronousInsertThreads​

AsynchronousInsert スレッドプール内のスレッド数。

AsynchronousInsertThreadsActive​

タスクを実行中の AsynchronousInsert スレッドプール内のスレッド数。

AsynchronousReadWait​

非同期読み取りを待機しているスレッド数。

BackgroundBufferFlushSchedulePoolSize​

BackgroundBufferFlushSchedulePool 内のタスク数の上限。

BackgroundBufferFlushSchedulePoolTask​

BackgroundBufferFlushSchedulePool 内のアクティブなタスク数。このプールは、定期的な Buffer フラッシュに使用されます。

BackgroundCommonPoolSize​

関連付けられたバックグラウンドプール内のタスク数の上限。

BackgroundCommonPoolTask​

関連付けられたバックグラウンドプール内のアクティブなタスク数。

BackgroundDistributedSchedulePoolSize​

BackgroundDistributedSchedulePool 内のタスク数の上限。

BackgroundDistributedSchedulePoolTask​

BackgroundDistributedSchedulePool 内のアクティブなタスク数。このプールは、バックグラウンドで行われる分散送信に使用されます。

BackgroundFetchesPoolSize​

関連付けられたバックグラウンドプール内で同時に実行できるフェッチの上限数。

BackgroundFetchesPoolTask​

関連付けられたバックグラウンドプール内のアクティブなフェッチ数。

BackgroundMergesAndMutationsPoolSize​

関連付けられたバックグラウンドプール内のアクティブなマージおよびミューテーションの上限数。

BackgroundMergesAndMutationsPoolTask​

関連付けられたバックグラウンドプール内のアクティブなマージおよびミューテーションの数。

BackgroundMessageBrokerSchedulePoolSize​

メッセージストリーミング用の BackgroundProcessingPool 内のタスク数の上限。

BackgroundMessageBrokerSchedulePoolTask​

メッセージストリーミング用の BackgroundProcessingPool 内のアクティブなタスク数。

BackgroundMovePoolSize​

移動処理用の BackgroundProcessingPool 内のタスク数の上限。

BackgroundMovePoolTask​

移動処理用の BackgroundProcessingPool 内のアクティブなタスク数。

BackgroundSchedulePoolSize​

BackgroundSchedulePool 内のタスク数の上限。このプールは、古いデータパーツの削除、データパーツの変更、レプリカの再初期化など、ReplicatedMergeTree の定期タスクに使用されます。

BackgroundSchedulePoolTask​

BackgroundSchedulePool 内のアクティブなタスク数。このプールは、古いデータパーツの削除、データパーツの変更、レプリカの再初期化など、ReplicatedMergeTree の定期タスクに使用されます。

BackupsIOThreads​

BackupsIO スレッドプール内のスレッド数。

BackupsIOThreadsActive​

タスクを実行中の BackupsIO スレッドプール内のスレッド数。

BackupsThreads​

BACKUP 用スレッドプール内のスレッド数。

BackupsThreadsActive​

タスクを実行中の BACKUP 用スレッドプール内のスレッド数。

BrokenDistributedFilesToInsert​

Distributed テーブルへの非同期挿入用ファイルのうち、破損としてマークされたファイル数。このメトリクスは起動時に 0 から開始します。各シャードのファイル数が合算されます。

CacheDetachedFileSegments​

存在するデタッチ済みキャッシュファイルセグメントの数。

CacheDictionaryThreads​

CacheDictionary スレッドプール内のスレッド数。

CacheDictionaryThreadsActive​

タスクを実行中の CacheDictionary スレッドプール内のスレッド数。

CacheDictionaryUpdateQueueBatches​

CacheDictionary の更新キュー内に存在する「バッチ」（キーの集合）の数。

CacheDictionaryUpdateQueueKeys​

CacheDictionary の更新キュー内に存在するキーの正確な数。

CacheFileSegments​

既存のキャッシュファイルセグメントの数。

ContextLockWait​

Context 内でロック待ちをしているスレッド数。このロックはグローバルロック。

DDLWorkerThreads​

ON CLUSTER クエリ用の DDLWorker スレッドプール内のスレッド数。

DDLWorkerThreadsActive​

ON CLUSTER クエリ用の DDLWorker スレッドプール内でタスクを実行中のスレッド数。

DatabaseCatalogThreads​

DatabaseCatalog スレッドプール内のスレッド数。

DatabaseCatalogThreadsActive​

DatabaseCatalog スレッドプール内でタスクを実行中のスレッド数。

DatabaseOnDiskThreads​

DatabaseOnDisk スレッドプール内のスレッド数。

DatabaseOnDiskThreadsActive​

DatabaseOnDisk スレッドプール内でタスクを実行中のスレッド数。

DelayedInserts​

MergeTree テーブルのあるパーティションでアクティブなデータパーツ数が多すぎるためにスロットリングされている INSERT クエリの数。

DestroyAggregatesThreads​

集約状態の破棄用スレッドプール内のスレッド数。

DestroyAggregatesThreadsActive​

集約状態の破棄用スレッドプール内でタスクを実行中のスレッド数。

DictCacheRequests​

キャッシュ型ディクショナリのデータソースに対して送信中のリクエスト数。

DiskObjectStorageAsyncThreads​

DiskObjectStorage 用の非同期スレッドプール内のスレッド数。

DiskObjectStorageAsyncThreadsActive​

DiskObjectStorage 用の非同期スレッドプール内でタスクを実行中のスレッド数。

DiskSpaceReservedForMerge​

現在実行中のバックグラウンドマージのために予約されているディスク容量。現在マージ中のパーツ合計サイズよりわずかに多くなる。

DistributedFilesToInsert​

Distributed テーブルへの非同期挿入のために処理待ちとなっているファイル数。各シャードごとのファイル数の合計。

DistributedSend​

Distributed テーブルに対して INSERT されたデータを送信しているリモートサーバーへの接続数。同期・非同期モードの両方を含む。

EphemeralNode​

ZooKeeper で保持しているエフェメラル（一時）ノードの数。

FilesystemCacheElements​

ファイルシステムキャッシュ要素（ファイルセグメント）。

FilesystemCacheReadBuffers​

アクティブなキャッシュバッファの数。

FilesystemCacheSize​

ファイルシステムキャッシュのサイズ（バイト単位）。

QueryCacheBytes​

クエリキャッシュの合計サイズ（バイト単位）。

QueryCacheEntries​

クエリキャッシュ内のエントリ総数。

UncompressedCacheBytes​

非圧縮キャッシュの合計サイズ（バイト単位）。非圧縮キャッシュは通常パフォーマンスを改善せず、ほとんどの場合は使用を避けるべき。

UncompressedCacheCells​

CompiledExpressionCacheBytes​

JIT コンパイルされたコードのキャッシュに使用されている合計バイト数。

CompiledExpressionCacheCount​

JIT コンパイルされたコードのキャッシュ内のエントリ総数。

MMapCacheCells​

mmap（メモリマップ）で開かれているファイル数。これは、設定 local_filesystem_read_method が mmap に設定されたクエリで使用される。mmap で開かれたファイルは、高コストな TLB フラッシュを避けるためキャッシュに保持される。

MarkCacheBytes​

マークキャッシュの合計サイズ（バイト単位）。

MarkCacheFiles​

マークキャッシュ内にキャッシュされているマークファイルの総数。

GlobalThread​

グローバルスレッドプール内のスレッド数。

GlobalThreadActive​

グローバルスレッドプール内でタスクを実行中のスレッド数。

HTTPConnection​

HTTP サーバーへの接続数。

HashedDictionaryThreads​

HashedDictionaryThreads​

HashedDictionary スレッドプール内のスレッド数。

HashedDictionaryThreadsActive​

タスクを実行中の HashedDictionary スレッドプール内のスレッド数。

IOPrefetchThreads​

IO プリフェッチスレッドプール内のスレッド数。

IOPrefetchThreadsActive​

タスクを実行中の IO プリフェッチスレッドプール内のスレッド数。

IOThreads​

IO スレッドプール内のスレッド数。

IOThreadsActive​

タスクを実行中の IO スレッドプール内のスレッド数。

IOUringInFlightEvents​

処理中（in flight）の io_uring SQE の数。

IOUringPendingEvents​

送信待ちの io_uring SQE の数。

IOWriterThreads​

IO ライタースレッドプール内のスレッド数。

IOWriterThreadsActive​

タスクを実行中の IO ライタースレッドプール内のスレッド数。

InterserverConnection​

パーツを取得するために他のレプリカから確立されている接続数。

KafkaAssignedPartitions​

Kafka テーブルに現在割り当てられているパーティション数。

KafkaBackgroundReads​

現在動作中のバックグラウンドリードの数（Kafka からマテリアライズドビューを構築しているもの）。

KafkaConsumers​

アクティブな Kafka コンシューマーの数。

KafkaConsumersInUse​

現在、直接またはバックグラウンドリードで使用されているコンシューマーの数。

KafkaConsumersWithAssignment​

何らかのパーティションが割り当てられているアクティブな Kafka コンシューマーの数。

KafkaLibrdkafkaThreads​

アクティブな librdkafka スレッドの数。

KafkaProducers​

作成済みのアクティブな Kafka プロデューサーの数。

KafkaWrites​

Kafka への実行中の INSERT の数。

KeeperAliveConnections​

有効な接続数。

KeeperOutstandingRequests​

未処理リクエスト数。

LocalThread​

ローカルスレッドプール内のスレッド数。ローカルスレッドプール内のスレッドはグローバルスレッドプールから取得されます。

LocalThreadActive​

タスクを実行中のローカルスレッドプール内のスレッド数。

MMappedAllocBytes​

mmapped アロケーションのバイト数合計。

MMappedAllocs​

mmapped アロケーションの総数。

MMappedFileBytes​

mmapped ファイル領域のサイズ合計。

MMappedFiles​

mmapped ファイルの総数。

MarksLoaderThreads​

マークをロードするためのスレッドプール内のスレッド数。

MarksLoaderThreadsActive​

タスクを実行中の、マークをロードするためのスレッドプール内のスレッド数。

MaxDDLEntryID​

DDLWorker が処理した DDL エントリ ID の最大値。

MaxPushedDDLEntryID​

DDLWorker が ZooKeeper にプッシュした DDL エントリ ID の最大値。

MemoryTracking​

サーバーによって割り当てられたメモリ総量（バイト単位）。

Merge​

実行中のバックグラウンドマージの数。

MergeTreeAllRangesAnnouncementsSent​

データパーツ集合（MergeTree テーブル用）について、リモートサーバーからイニシエーターサーバーに対して送信中（in flight）のアナウンスの現在の数。リモートサーバー側で計測されます。

MergeTreeBackgroundExecutorThreads​

MergeTreeBackgroundExecutor スレッドプール内のスレッド数。

MergeTreeBackgroundExecutorThreadsActive​

タスクを実行中の MergeTreeBackgroundExecutor スレッドプール内のスレッド数。

MergeTreeDataSelectExecutorThreads​

MergeTreeDataSelectExecutor スレッドプール内のスレッド数。

MergeTreeDataSelectExecutorThreadsActive​

タスクを実行中の MergeTreeDataSelectExecutor スレッドプール内のスレッド数。

MergeTreePartsCleanerThreads​

MergeTree パーツクリーナースレッドプール内のスレッド数。

MergeTreePartsCleanerThreadsActive​

タスクを実行中の、MergeTree パーツクリーナー用スレッドプール内のスレッド数。

MergeTreePartsLoaderThreads​

MergeTree パーツローダー用スレッドプール内のスレッド数。

MergeTreePartsLoaderThreadsActive​

タスクを実行中の、MergeTree パーツローダー用スレッドプール内のスレッド数。

MergeTreeReadTaskRequestsSent​

リモートサーバーから読み取りタスクを選択するために（MergeTree テーブル用）発行元サーバーへ送信中のコールバックリクエスト数（現在の数）。リモートサーバー側で計測されます。

Move​

現在実行中の MOVE 操作数。

MySQLConnection​

MySQL プロトコルを使用しているクライアント接続数。

NetworkReceive​

ネットワークからデータを受信しているスレッド数。ClickHouse 関連のネットワーク処理のみが含まれ、サードパーティライブラリによるものは含まれません。

NetworkSend​

ネットワークへデータを送信しているスレッド数。ClickHouse 関連のネットワーク処理のみが含まれ、サードパーティライブラリによるものは含まれません。

OpenFileForRead​

読み取り用にオープンされているファイル数。

OpenFileForWrite​

書き込み用にオープンされているファイル数。

ParallelFormattingOutputFormatThreads​

ParallelFormattingOutputFormatThreads スレッドプール内のスレッド数。

ParallelFormattingOutputFormatThreadsActive​

タスクを実行中の、ParallelFormattingOutputFormatThreads スレッドプール内のスレッド数。

PartMutation​

ミューテーション（ALTER DELETE/UPDATE）の数。

PartsActive​

現在および今後の SELECT で使用されるアクティブなデータパーツ数。

PartsCommitted​

非推奨。PartsActive を参照してください。

PartsCompact​

コンパクトパーツ数。

PartsDeleteOnDestroy​

別のディスクに移動され、自身のデストラクタ内で削除されるべきパーツ数。

PartsDeleting​

参照カウンタが 1 の非アクティブなデータパーツで、現在クリーナーによって削除中のものの数。

PartsOutdated​

非アクティブなデータパーツだが、現在の SELECT のみで使用される可能性があり、SELECT の完了後に削除可能なものの数。

PartsPreActive​

data_parts 内には存在するが、SELECT では使用されていないパーツ数。

PartsPreCommitted​

非推奨。PartsPreActive を参照してください。

PartsTemporary​

現在生成中であり、data_parts リストには含まれていないパーツ数。

PartsWide​

ワイドパーツ数。

PendingAsyncInsert​

フラッシュ待ちの非同期 INSERT の数。

PostgreSQLConnection​

PostgreSQL プロトコルを使用しているクライアント接続数。

Query​

実行中のクエリ数。

QueryPreempted​

priority 設定により停止され待機中のクエリ数。

QueryThread​

クエリ処理スレッド数。

RWLockActiveReaders​

テーブルの RWLock で読み取りロックを保持しているスレッド数。

RWLockActiveWriters​

テーブルの RWLock で書き込みロックを保持しているスレッド数。

RWLockWaitingReaders​

テーブルの RWLock で読み取り待ち状態のスレッド数。

RWLockWaitingWriters​

テーブルの RWLock で書き込み待ち状態のスレッド数。

Read​

進行中の読み取り系（read, pread, io_getevents など）システムコール数。

ReadTaskRequestsSent​

リモートサーバーから読み取りタスクを選択するために（s3Cluster テーブル関数など用）発行元サーバーへ送信中のコールバックリクエスト数（現在の数）。リモートサーバー側で計測されます。

ReadonlyReplica​

ZooKeeper セッション喪失後の再初期化、または ZooKeeper 未設定での起動により、現在 readonly 状態にある Replicated テーブルの数。

RemoteRead​

リモートリーダーで実行中の読み取り処理数。

ReplicatedChecks​

一貫性チェック中のデータパーツ数。

ReplicatedFetch​

レプリカからフェッチ中のデータパーツ数。

ReplicatedSend​

レプリカへ送信中のデータパーツ数。

RestartReplicaThreads​

RESTART REPLICA スレッドプール内のスレッド数。

RestartReplicaThreadsActive​

タスクを実行中の RESTART REPLICA スレッドプール内のスレッド数。

RestoreThreads​

RESTORE 用スレッドプール内のスレッド数。

RestoreThreadsActive​

タスクを実行中の RESTORE 用スレッドプール内のスレッド数。

Revision​

サーバーのリビジョン。パッチリリースを除き、各リリースまたはリリース候補ごとに増加する数値。

S3Requests​

S3 リクエスト数。

SendExternalTables​

外部テーブル用のデータをリモートサーバーに送信している接続数。外部テーブルは、分散サブクエリを伴う GLOBAL IN および GLOBAL JOIN 演算子を実装するために使用されます。

SendScalars​

スカラー値用のデータをリモートサーバーに送信している接続数。

StorageBufferBytes​

Buffer テーブルのバッファ内のバイト数。

StorageBufferRows​

Buffer テーブルのバッファ内の行数。

StorageDistributedThreads​

StorageDistributed スレッドプール内のスレッド数。

StorageDistributedThreadsActive​

タスクを実行中の StorageDistributed スレッドプール内のスレッド数。

StorageHiveThreads​

StorageHive スレッドプール内のスレッド数。

StorageHiveThreadsActive​

タスクを実行中の StorageHive スレッドプール内のスレッド数。

StorageS3Threads​

StorageS3 スレッドプール内のスレッド数。

StorageS3ThreadsActive​

タスクを実行中の StorageS3 スレッドプール内のスレッド数。

SystemReplicasThreads​

system.replicas スレッドプール内のスレッド数。

SystemReplicasThreadsActive​

タスクを実行中の system.replicas スレッドプール内のスレッド数。

TCPConnection​

TCP サーバー（ネイティブインターフェイスを持つクライアント）への接続数。サーバー間の分散クエリ接続も含まれます。

TablesToDropQueueSize​

バックグラウンドでのデータ削除を待機している削除済みテーブルの数。

TemporaryFilesForAggregation​

外部集約のために作成された一時ファイル数。

TemporaryFilesForJoin​

JOIN 用に作成された一時ファイル数。

TemporaryFilesForSort​

外部ソートのために作成された一時ファイル数。

TemporaryFilesUnknown​

用途が不明な一時ファイル数。

ThreadPoolFSReaderThreads​

local_filesystem_read_method=threadpool 用スレッドプール内のスレッド数。

ThreadPoolFSReaderThreadsActive​

タスクを実行中の local_filesystem_read_method=threadpool 用スレッドプール内のスレッド数。

ThreadPoolRemoteFSReaderThreads​

remote_filesystem_read_method=threadpool 用スレッドプール内のスレッド数。

ThreadPoolRemoteFSReaderThreadsActive​

タスクを実行中の remote_filesystem_read_method=threadpool 用スレッドプール内のスレッド数。

ThreadsInOvercommitTracker​

OvercommitTracker 内で待機しているスレッド数。

TotalTemporaryFiles​

作成された一時ファイルの総数。

VersionInteger​

サーバーのバージョンを base-1000 の単一の整数で表した値。たとえば、バージョン 11.22.33 は 11022033 に変換されます。

Write​

発行された書き込み（write, pwrite, io_getevents など）システムコールの数。

ZooKeeperRequest​

発行された ZooKeeper へのリクエスト数。

ZooKeeperSession​

ZooKeeper へのセッション（接続）数。1 つを超えてはなりません。複数の ZooKeeper 接続を使用すると、ZooKeeper の整合性モデルが許容する線形化されない動作（古い読み取り）によりバグを引き起こす可能性があるためです。

ZooKeeperWatch​

ZooKeeper におけるウォッチ（イベント購読）の数。

ConcurrencyControlAcquired​

取得された CPU スロットの総数。

ConcurrencyControlSoftLimit​

CPU スロット数に対するソフトリミットの値。

関連項目

  • system.asynchronous_metrics — 定期的に計算されるメトリクスを格納します。
  • system.events — 発生したイベントの数を格納します。
  • system.metric_log — テーブル system.metrics および system.events のメトリクス値の履歴を格納します。
  • Monitoring — ClickHouse の監視の基本概念。