Перейти к основному содержанию
Перейти к основному содержанию

system.metrics

Querying in ClickHouse Cloud

The data in this system table is held locally on each node in ClickHouse Cloud. Obtaining a complete view of all data, therefore, requires the clusterAllReplicas function. See here for further details.

Содержит метрики, которые могут быть рассчитаны на лету или имеют текущее значение. Например, количество одновременно обрабатываемых запросов или текущую задержку реплики. Эта таблица всегда содержит актуальные данные.

Столбцы:

  • 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​

Количество потоков в пуле потоков foreground для асинхронного загрузчика (async loader).

TablesLoaderForegroundThreadsActive​

Количество потоков в пуле потоков foreground для асинхронного загрузчика (async loader), выполняющих задачу.

TablesLoaderBackgroundThreads​

Количество потоков в пуле потоков background для асинхронного загрузчика (async loader).

TablesLoaderBackgroundThreadsActive​

Количество потоков в пуле потоков background для асинхронного загрузчика (async loader), выполняющих задачу.

AsyncInsertCacheSize​

Количество hash id асинхронных вставок в кэше.

AsynchronousInsertThreads​

Количество потоков в пуле потоков AsynchronousInsert.

AsynchronousInsertThreadsActive​

Количество потоков в пуле потоков AsynchronousInsert, выполняющих задачу.

AsynchronousReadWait​

Количество потоков, ожидающих асинхронного чтения.

BackgroundBufferFlushSchedulePoolSize​

Ограничение на количество задач в BackgroundBufferFlushSchedulePool.

BackgroundBufferFlushSchedulePoolTask​

Количество активных задач в BackgroundBufferFlushSchedulePool. Этот пул используется для периодического сброса (flush) таблиц Buffer.

BackgroundCommonPoolSize​

Ограничение на количество задач в связанном background-пуле.

BackgroundCommonPoolTask​

Количество активных задач в связанном background-пуле.

BackgroundDistributedSchedulePoolSize​

Ограничение на количество задач в BackgroundDistributedSchedulePool.

BackgroundDistributedSchedulePoolTask​

Количество активных задач в BackgroundDistributedSchedulePool. Этот пул используется для фоновой отправки данных в распределённые таблицы.

BackgroundFetchesPoolSize​

Ограничение на количество одновременных операций fetch в связанном background-пуле.

BackgroundFetchesPoolTask​

Количество активных операций fetch в связанном background-пуле.

BackgroundMergesAndMutationsPoolSize​

Ограничение на количество активных операций слияний (merge) и мутаций в связанном background-пуле.

BackgroundMergesAndMutationsPoolTask​

Количество активных операций слияний (merge) и мутаций в связанном background-пуле.

BackgroundMessageBrokerSchedulePoolSize​

Ограничение на количество задач в BackgroundProcessingPool для потоковой обработки сообщений (message streaming).

BackgroundMessageBrokerSchedulePoolTask​

Количество активных задач в BackgroundProcessingPool для потоковой обработки сообщений (message streaming).

BackgroundMovePoolSize​

Ограничение на количество задач в BackgroundProcessingPool для операций перемещения (move).

BackgroundMovePoolTask​

Количество активных задач в BackgroundProcessingPool для операций перемещения (move).

BackgroundSchedulePoolSize​

Ограничение на количество задач в BackgroundSchedulePool. Этот пул используется для периодических задач ReplicatedMergeTree, таких как очистка старых кусков данных, изменение кусков данных, переинициализация реплик и т. д.

BackgroundSchedulePoolTask​

Количество активных задач в BackgroundSchedulePool. Этот пул используется для периодических задач ReplicatedMergeTree, таких как очистка старых кусков данных, изменение кусков данных, переинициализация реплик и т. д.

BackupsIOThreads​

Количество потоков в пуле потоков BackupsIO.

BackupsIOThreadsActive​

Количество потоков в пуле потоков BackupsIO, выполняющих задачу.

BackupsThreads​

Количество потоков в пуле потоков для BACKUP.

BackupsThreadsActive​

Количество потоков в пуле потоков для BACKUP, выполняющих задачу.

BrokenDistributedFilesToInsert​

Количество файлов для асинхронной вставки в таблицы Distributed, помеченных как повреждённые. Эта метрика при запуске будет начинаться с 0. Количество файлов для каждого шарда суммируется.

CacheDetachedFileSegments​

Количество существующих отсоединённых сегментов файлов кэша.

CacheDictionaryThreads​

Количество потоков в пуле потоков CacheDictionary.

CacheDictionaryThreadsActive​

Количество потоков в пуле потоков CacheDictionary, выполняющих задачу.

Количество потоков в пуле потоков CacheDictionary, выполняющих задачу.

CacheDictionaryUpdateQueueBatches​

Количество «пакетов» (наборов ключей) в очереди обновления в CacheDictionaries.

CacheDictionaryUpdateQueueKeys​

Точное количество ключей в очереди обновления в CacheDictionaries.

CacheFileSegments​

Количество существующих сегментов файлов кэша

ContextLockWait​

Количество потоков, ожидающих блокировку в Context. Это глобальная блокировка.

DDLWorkerThreads​

Количество потоков в пуле потоков DDLWorker для запросов ON CLUSTER.

DDLWorkerThreadsActive​

Количество потоков в пуле потоков DDLWorker для запросов ON CLUSTER, выполняющих задачу.

DatabaseCatalogThreads​

Количество потоков в пуле потоков DatabaseCatalog.

DatabaseCatalogThreadsActive​

Количество потоков в пуле потоков DatabaseCatalog, выполняющих задачу.

DatabaseOnDiskThreads​

Количество потоков в пуле потоков DatabaseOnDisk.

DatabaseOnDiskThreadsActive​

Количество потоков в пуле потоков DatabaseOnDisk, выполняющих задачу.

DelayedInserts​

Количество запросов INSERT, чья работа замедляется из-за большого числа активных кусков данных для партиции в таблице MergeTree.

DestroyAggregatesThreads​

Количество потоков в пуле потоков для удаления агрегатных состояний.

DestroyAggregatesThreadsActive​

Количество потоков в пуле потоков для удаления агрегатных состояний, выполняющих задачу.

DictCacheRequests​

Количество запросов «на лету» к источникам данных кэш-словарей.

DiskObjectStorageAsyncThreads​

Количество потоков в асинхронном пуле потоков для DiskObjectStorage.

DiskObjectStorageAsyncThreadsActive​

Количество потоков в асинхронном пуле потоков для DiskObjectStorage, выполняющих задачу.

DiskSpaceReservedForMerge​

Дисковое пространство, зарезервированное для текущих фоновых слияний. Оно немного больше суммарного размера сливаемых сейчас кусков.

DistributedFilesToInsert​

Количество отложенных файлов для обработки при асинхронной вставке в таблицы Distributed. Количество файлов по каждому шарду суммируется.

DistributedSend​

Количество соединений с удалёнными серверами, отправляющих данные, вставленные в таблицы Distributed. Включает как синхронный, так и асинхронный режим.

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​

Количество потоков в пуле потоков HashedDictionary.

HashedDictionaryThreadsActive​

Количество потоков в пуле потоков HashedDictionary, выполняющих задачу.

IOPrefetchThreads​

Количество потоков в пуле потоков предварительной выборки ввода-вывода (IO prefetch).

IOPrefetchThreadsActive​

Количество потоков в пуле потоков предварительной выборки ввода-вывода (IO prefetch), выполняющих задачу.

IOThreads​

Количество потоков в пуле потоков ввода-вывода (IO).

IOThreadsActive​

Количество потоков в пуле потоков ввода-вывода (IO), выполняющих задачу.

IOUringInFlightEvents​

Количество SQE io_uring, находящихся в обработке

IOUringPendingEvents​

Количество SQE io_uring, ожидающих отправки

IOWriterThreads​

Количество потоков в пуле потоков записи ввода-вывода (IO writer).

IOWriterThreadsActive​

Количество потоков в пуле потоков записи ввода-вывода (IO writer), выполняющих задачу.

InterserverConnection​

Количество соединений от других реплик для получения кусков данных

KafkaAssignedPartitions​

Количество разделов, к которым в данный момент назначены таблицы Kafka

KafkaBackgroundReads​

Количество фоновых чтений, которые сейчас выполняются (заполняют материализованные представления из Kafka)

KafkaConsumers​

Количество активных потребителей Kafka

KafkaConsumersInUse​

Количество потребителей, которые в данный момент используются прямыми или фоновыми чтениями

KafkaConsumersWithAssignment​

Количество активных потребителей Kafka, которым назначены какие-либо разделы.

KafkaLibrdkafkaThreads​

Количество активных потоков librdkafka

KafkaProducers​

Количество созданных активных продюсеров Kafka

KafkaWrites​

Количество в данный момент выполняемых вставок в Kafka

KeeperAliveConnections​

Количество активных соединений

KeeperOutstandingRequests​

Количество запросов, ожидающих обработки

LocalThread​

Количество потоков в локальных пулах потоков. Потоки в локальных пулах потоков берутся из глобального пула потоков.

LocalThreadActive​

Количество потоков в локальных пулах потоков, выполняющих задачу.

MMappedAllocBytes​

Суммарный объём (в байтах) выделений через mmap

MMappedAllocs​

Общее количество выделений через mmap

MMappedFileBytes​

Суммарный размер областей файлов, отображённых в память (mmap).

MMappedFiles​

Общее количество файлов, отображённых в память (mmap).

MarksLoaderThreads​

Количество потоков в пуле потоков для загрузки меток.

MarksLoaderThreadsActive​

Количество потоков в пуле потоков для загрузки меток, выполняющих задачу.

MaxDDLEntryID​

Максимальный обработанный идентификатор записи DDL у DDLWorker.

MaxPushedDDLEntryID​

Максимальный идентификатор записи DDL у DDLWorker, отправленной в ZooKeeper.

MemoryTracking​

Общий объём памяти (в байтах), выделенной сервером.

Merge​

Количество выполняемых фоновых слияний

MergeTreeAllRangesAnnouncementsSent​

Текущее количество уведомлений, отправляемых в данный момент с удалённого сервера инициирующему серверу о наборе кусков данных (для таблиц MergeTree). Измеряется на стороне удалённого сервера.

MergeTreeBackgroundExecutorThreads​

Количество потоков в пуле потоков MergeTreeBackgroundExecutor.

MergeTreeBackgroundExecutorThreadsActive​

Количество потоков в пуле потоков MergeTreeBackgroundExecutor, выполняющих задачу.

MergeTreeDataSelectExecutorThreads​

Количество потоков в пуле потоков MergeTreeDataSelectExecutor.

MergeTreeDataSelectExecutorThreadsActive​

Количество потоков в пуле потоков MergeTreeDataSelectExecutor, выполняющих задачу.

MergeTreePartsCleanerThreads​

Количество потоков в пуле потоков очистки кусков MergeTree.

MergeTreePartsCleanerThreadsActive​

Количество потоков в пуле потоков очистки частей MergeTree, выполняющих задачу.

MergeTreePartsLoaderThreads​

Количество потоков в пуле потоков загрузчика частей MergeTree.

MergeTreePartsLoaderThreadsActive​

Количество потоков в пуле потоков загрузчика частей MergeTree, выполняющих задачу.

MergeTreeReadTaskRequestsSent​

Текущее количество активных callback-запросов, отправленных с удалённого сервера обратно на сервер-инициатор для выбора задачи чтения (для таблиц MergeTree). Измеряется на стороне удалённого сервера.

Move​

Количество операций перемещения, выполняющихся в данный момент

MySQLConnection​

Количество клиентских соединений, использующих протокол MySQL

NetworkReceive​

Количество потоков, получающих данные из сети. Учитывается только сетевое взаимодействие, связанное с ClickHouse, без учёта сторонних библиотек.

NetworkSend​

Количество потоков, отправляющих данные в сеть. Учитывается только сетевое взаимодействие, связанное с ClickHouse, без учёта сторонних библиотек.

OpenFileForRead​

Количество файлов, открытых для чтения

OpenFileForWrite​

Количество файлов, открытых для записи

ParallelFormattingOutputFormatThreads​

Количество потоков в пуле потоков ParallelFormattingOutputFormatThreads.

ParallelFormattingOutputFormatThreadsActive​

Количество потоков в пуле потоков ParallelFormattingOutputFormatThreads, выполняющих задачу.

PartMutation​

Количество мутаций (ALTER DELETE/UPDATE)

PartsActive​

Активная часть данных, используемая текущими и следующими запросами SELECT.

PartsCommitted​

Устарело. См. PartsActive.

PartsCompact​

Компактные части.

PartsDeleteOnDestroy​

Часть была перемещена на другой диск и должна быть удалена в собственном деструкторе.

PartsDeleting​

Неактивная часть данных с единичным счётчиком ссылок, в данный момент удаляется потоком очистки.

PartsOutdated​

Неактивная часть данных, которая может использоваться только текущими запросами SELECT и может быть удалена после завершения этих запросов SELECT.

PartsPreActive​

Часть находится в data_parts, но не используется для запросов SELECT.

PartsPreCommitted​

Устарело. См. PartsPreActive.

PartsTemporary​

Часть сейчас генерируется, она ещё не находится в списке data_parts.

PartsWide​

Широкие части.

PendingAsyncInsert​

Количество асинхронных вставок, ожидающих сброса на диск.

PostgreSQLConnection​

Количество клиентских соединений, использующих протокол PostgreSQL

Query​

Количество выполняющихся запросов

QueryPreempted​

Количество запросов, которые остановлены и ожидают из-за настройки priority.

QueryThread​

Количество потоков обработки запросов

RWLockActiveReaders​

Количество потоков, удерживающих блокировку на чтение в RWLock таблицы.

RWLockActiveWriters​

Количество потоков, удерживающих блокировку на запись в RWLock таблицы.

RWLockWaitingReaders​

Количество потоков, ожидающих чтения в RWLock таблицы.

RWLockWaitingWriters​

Количество потоков, ожидающих записи в RWLock таблицы.

Read​

Количество системных вызовов чтения (read, pread, io_getevents и т. д.), выполняющихся в данный момент

ReadTaskRequestsSent​

Текущее количество активных callback-запросов, отправленных с удалённого сервера обратно на сервер-инициатор для выбора задачи чтения (для функции таблицы s3Cluster и подобных). Измеряется на стороне удалённого сервера.

ReadonlyReplica​

Количество реплицируемых таблиц, которые сейчас находятся в состоянии readonly из-за повторной инициализации после потери сессии ZooKeeper или из-за запуска без настроенного ZooKeeper.

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. Их должно быть не более одного, так как использование более чем одного соединения с ZooKeeper может привести к ошибкам из-за отсутствия линеаризуемости (устаревшие чтения), допускаемой моделью согласованности ZooKeeper.

ZooKeeperWatch​

Количество наблюдений (подписок на события) в ZooKeeper.

ConcurrencyControlAcquired​

Общее количество занятых CPU-слотов.

ConcurrencyControlSoftLimit​

Значение мягкого ограничения на количество CPU-слотов.

См. также

  • system.asynchronous_metrics — Содержит периодически вычисляемые метрики.
  • system.events — Содержит количество произошедших событий.
  • system.metric_log — Содержит историю значений метрик из таблиц system.metrics и system.events.
  • Monitoring — Базовые концепции мониторинга ClickHouse.