system.metrics
ClickHouse Cloud でのクエリ実行
このシステムテーブルのデータは、ClickHouse Cloud の各ノードにローカルに格納されています。そのため、すべてのデータを包括的に確認するには、clusterAllReplicas 関数を使用する必要があります。詳細についてはこちらを参照してください。
即座に計算できるメトリクス、または現在値を表すメトリクスを含みます。例えば、同時に処理されているクエリ数や、現在のレプリカ遅延などです。このテーブルの内容は常に最新です。
列:
サポートされているメトリクスの一覧は、ソースファイル src/Common/CurrentMetrics.cpp で確認できます。
例
メトリクスの説明
| メトリクス | 説明 |
|---|---|
| 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 | 破損としてマークされた分散テーブルへの非同期挿入用ファイル数（0 から始まり、すべての分片で合計） |
| CacheDetachedFileSegments | 既存のデタッチされたキャッシュファイルセグメント数 |
| CacheDictionaryThreads | CacheDictionary スレッドプールのスレッド数 |
| CacheDictionaryThreadsActive | タスクを実行中の CacheDictionary スレッドプール内のスレッド数 |
| CacheDictionaryUpdateQueueBatches | CacheDictionaries の更新キュー内にある 'batches'（キー集合）の数 |
| CacheDictionaryUpdateQueueKeys | CacheDictionaries の更新キュー内のキー数（正確値） |
| CacheFileSegments | 既存のキャッシュファイルセグメント数 |
| ContextLockWait | Context（グローバルロック）でロック獲得を待機しているスレッド数 |
| DDLWorkerThreads | ON CLUSTER クエリ向け DDLWorker スレッドプールのスレッド数 |
| DDLWorkerThreadsActive | ON CLUSTER クエリ用 DDLWORKER スレッドプールにおいてタスクを実行中のスレッド数 |
| DatabaseCatalogThreads | DatabaseCatalog のスレッドプール内のスレッド数 |
| DatabaseCatalogThreadsActive | タスクを実行している DatabaseCatalog スレッドプール内のスレッド数 |
| DatabaseOnDiskThreads | DatabaseOnDisk スレッドプールのスレッド数 |
| DatabaseOnDiskThreadsActive | DatabaseOnDisk スレッドプール内でタスクを実行しているスレッド数 |
| DelayedInserts | MergeTree テーブルのパーティションでアクティブなデータパーツ数が多すぎるためスロットルされた INSERT クエリの数 |
| DestroyAggregatesThreads | 集約状態を破棄するためのスレッドプールのスレッド数 |
| DestroyAggregatesThreadsActive | destroy aggregate states 用スレッドプールでタスクを実行中のスレッド数 |
| DictCacheRequests | キャッシュ型辞書のデータソースに対する処理中のリクエスト数 |
| DiskObjectStorageAsyncThreads | DiskObjectStorage の非同期スレッドプールのスレッド数 |
| DiskObjectStorageAsyncThreadsActive | DiskObjectStorage の非同期スレッドプール内でタスクを実行中のスレッド数 |
| DiskSpaceReservedForMerge | バックグラウンドで実行中のマージ用に予約されているディスク容量（マージ中のパーツの合計サイズよりわずかに多い） |
| DistributedFilesToInsert | 分散テーブルへの非同期挿入のために処理待ちとなっているファイル数（全分片の合計） |
| DistributedSend | 分散テーブルへのデータの INSERT を行っているリモートサーバーへの接続数（同期モードおよび非同期モードの両方） |
| EphemeralNode | ZooKeeper に存在するエフェメラルノード数 |
| FilesystemCacheElements | ファイルシステムキャッシュエントリ（ファイルセグメント） |
| FilesystemCacheReadBuffers | アクティブなキャッシュバッファ数 |
| FilesystemCacheSize | ファイルシステムキャッシュのサイズ（バイト数） |
| QueryCacheBytes | クエリキャッシュの総サイズ（バイト単位） |
| QueryCacheEntries | クエリキャッシュ内のエントリ数の合計 |
| UncompressedCacheBytes | 非圧縮キャッシュの総サイズ（バイト単位）。通常はパフォーマンス向上にはつながらないため、基本的には使用を避けるべきです。 |
| UncompressedCacheCells | 非圧縮キャッシュのセル数 |
| CompiledExpressionCacheBytes | JIT コンパイル済みコードのキャッシュで使用されている合計バイト数 |
| CompiledExpressionCacheCount | JIT コンパイルされたコード用キャッシュに含まれるエントリの総数 |
| MMapCacheCells | mmap を使ってオープンされているファイル数（メモリにマップされ、local_filesystem_read_method=mmap 設定時に使用され、TLB のフラッシュを回避するためにキャッシュされる） |
| MarkCacheBytes | マークキャッシュの合計サイズ（バイト数） |
| MarkCacheFiles | マークキャッシュに格納されているマークファイルの総数 |
| GlobalThread | グローバルスレッドプールのスレッド数 |
| GlobalThreadActive | グローバルスレッドプールでタスクを実行しているスレッド数 |
| HTTPConnection | HTTP サーバーへの接続数 |
| HashedDictionaryThreads | HashedDictionary スレッドプール内のスレッド数 |
| HashedDictionaryThreadsActive | タスクを実行している HashedDictionary スレッドプール内のスレッド数 |
| IOPrefetchThreads | IO プリフェッチスレッドプールのスレッド数 |
| IOPrefetchThreadsActive | IO プリフェッチスレッドプールでタスクを実行しているスレッド数 |
| IOThreads | IO スレッドプールのスレッド数 |
| IOThreadsActive | タスクを実行している IO スレッドプール内のスレッド数 |
| IOUringInFlightEvents | 処理中の io_uring SQE の数 |
| IOUringPendingEvents | 送信待ちの io_uring SQE 数 |
| IOWriterThreads | IO writer スレッドプールのスレッド数 |
| IOWriterThreadsActive | タスクを実行している IO ライタースレッドプールのスレッド数 |
| InterserverConnection | 他のレプリカからパーツを取得するための接続数 |
| KafkaAssignedPartitions | Kafka テーブルが現在割り当てられているパーティション数 |
| KafkaBackgroundReads | 現在動作中のバックグラウンド読み取り処理の数（Kafka から materialized view を構築しているもの） |
| KafkaConsumers | 稼働中の Kafka コンシューマ数 |
| KafkaConsumersInUse | 直接またはバックグラウンドの読み取りで現在使用されているコンシューマー数 |
| KafkaConsumersWithAssignment | パーティションが割り当てられているアクティブな Kafka コンシューマー数 |
| KafkaLibrdkafkaThreads | 稼働中の librdkafka スレッド数 |
| KafkaProducers | アクティブな Kafka プロデューサーの数 |
| KafkaWrites | 現在実行中の Kafka への書き込み数 |
| KeeperAliveConnections | 生存中の接続数 |
| KeeperOutstandingRequests | 保留中のリクエスト数 |
| LocalThread | グローバルスレッドプールから割り当てられたローカルスレッドプールのスレッド数 |
| LocalThreadActive | ローカルスレッドプールでタスクを実行しているスレッド数 |
| MMappedAllocBytes | メモリマップ (mmap) による割り当ての合計バイト数 |
| MMappedAllocs | メモリマップされたアロケーションの総数 |
| MMappedFileBytes | mmapped ファイル領域サイズの合計 |
| MMappedFiles | メモリマップされたファイルの総数 |
| MarksLoaderThreads | マーク読み込み用スレッドプールのスレッド数 |
| MarksLoaderThreadsActive | マーク読み込み用スレッドプールでタスクを実行中のスレッド数 |
| MaxDDLEntryID | DDLWorker が処理した最大の DDL エントリ |
| MaxPushedDDLEntryID | ZooKeeper に送信された DDLWorker の最大 DDL エントリ ID |
| MemoryTracking | サーバーが割り当てたメモリの総量（バイト単位） |
| Merge | 実行中のバックグラウンドマージ数 |
| MergeTreeAllRangesAnnouncementsSent | リモートサーバーからイニシエーターへの、データパーツ集合に関する送信中の通知の現在数（MergeTree テーブル向け、リモートサーバー側で測定） |
| 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 | identity refcounter を持つ非アクティブなデータパーツで、クリーナーにより現在削除中 |
| PartsOutdated | アクティブではないデータパーツだが、現在実行中の SELECT からのみ使用されている可能性があり、SELECT の完了後に削除可能 |
| PartsPreActive | パーツは data_parts 内に存在するが、SELECT では使用されていない |
| PartsPreCommitted | 非推奨。PartsPreActive を参照。 |
| PartsTemporary | 現在生成中のパーツで、data_parts リストにはまだ含まれていません |
| PartsWide | ワイド形式のパーツ |
| PendingAsyncInsert | フラッシュ待ちの非同期挿入数 |
| PostgreSQLConnection | PostgreSQL プロトコルを使用するクライアント接続数 |
| クエリ | 実行中のクエリ数 |
| QueryPreempted | 'priority' 設定により停止・待機中のクエリ数 |
| QueryThread | クエリ処理スレッド数 |
| RWLockActiveReaders | テーブルのRWLockで読み取りロックを保持しているスレッドの数 |
| RWLockActiveWriters | テーブルの RWLock で書き込みロックを保持しているスレッド数 |
| RWLockWaitingReaders | テーブルの RWLock で読み取りロックを待っているスレッド数 |
| RWLockWaitingWriters | テーブルのRWLockの書き込みロック取得を待っているスレッド数 |
| Read | 進行中の read 系システムコール（read、pread、io_getevents など）の数 |
| ReadTaskRequestsSent | リモートサーバーからイニシエータに送信される、読み取りタスクを選択するためのコールバック要求の現在の処理中数（s3Cluster など向けで、リモートサーバー側で計測） |
| ReadonlyReplica | ZooKeeper セッションの喪失後の再初期化、または ZooKeeper を構成しないまま起動したことにより読み取り専用状態になっている Replicated テーブルの数 |
| RemoteRead | リモートリーダーで実行中の読み取り数 |
| ReplicatedChecks | 整合性チェック中のデータパーツ数 |
| ReplicatedFetch | レプリカから取得中のデータパーツ数 |
| ReplicatedSend | レプリカへ送信中のデータパーツ数 |
| RestartReplicaThreads | RESTART REPLICA 用スレッドプールのスレッド数 |
| RestartReplicaThreadsActive | タスクを実行中の RESTART REPLICA 用スレッドプール内のスレッド数 |
| RestoreThreads | RESTORE 用スレッドプールのスレッド数 |
| RestoreThreadsActive | RESTORE 用スレッドプールで現在タスクを実行中のスレッド数 |
| リビジョン | サーバーのリビジョン（パッチリリースを除き、各リリースまたはリリース候補ごとにインクリメントされる番号） |
| 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 | サーバーのバージョンを 1000進の単一の整数値で表したもの（例: バージョン 11.22.33 = 11022033） |
| Write | 処理中の write 系（write、pwrite、io_getevents など）システムコール数 |
| ZooKeeperRequest | 同時処理中の ZooKeeper へのリクエスト数 |
| ZooKeeperSession | ZooKeeper へのセッション（接続）数（線形化可能性がないため、1 を超えないようにすることが推奨される） |
| ZooKeeperWatch | ZooKeeper におけるウォッチ（イベント購読）の数 |
| ConcurrencyControlAcquired | 取得済み CPU スロット数の合計 |
| ConcurrencyControlSoftLimit | CPU スロット数のソフトリミット値 |
関連項目
- system.asynchronous_metrics — 定期的に計算されるメトリクスが含まれます。
- system.events — 発生したイベントの数が含まれます。
- system.metric_log — テーブル
system.metricsとsystem.eventsのメトリクス値の履歴が含まれます。 - Monitoring — ClickHouse モニタリングの基本概念について説明します。
