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 │ Number of executing queries                                            │
│ Merge                                │     0 │ Number of executing background merges                                  │
│ PartMutation                         │     0 │ Number of mutations (ALTER DELETE/UPDATE)                              │
│ ReplicatedFetch                      │     0 │ Number of data parts being fetched from replicas                       │
│ ReplicatedSend                       │     0 │ Number of data parts being sent to replicas                            │
│ ReplicatedChecks                     │     0 │ Number of data parts checking for consistency                          │
│ BackgroundMergesAndMutationsPoolTask │     0 │ Number of active merges and mutations in an associated background pool │
│ BackgroundFetchesPoolTask            │     0 │ Number of active fetches in an associated background pool              │
│ BackgroundCommonPoolTask             │     0 │ Number of active tasks in an associated background pool                │
│ BackgroundMovePoolTask               │     0 │ Number of active tasks in BackgroundProcessingPool for moves           │
└──────────────────────────────────────┴───────┴────────────────────────────────────────────────────────────────────────┘

Описание метрик

Метрика	Описание
AggregatorThreads	Количество потоков в пуле Aggregator
AggregatorThreadsActive	Количество потоков в пуле потоков Aggregator, выполняющих задания
TablesLoaderForegroundThreads	Количество потоков в foreground-пуле асинхронного загрузчика
TablesLoaderForegroundThreadsActive	Количество потоков в пуле foreground-потоков асинхронного загрузчика, которые в данный момент выполняют задачу
TablesLoaderBackgroundThreads	Количество потоков в фоновом пуле асинхронного загрузчика
TablesLoaderBackgroundThreadsActive	Количество потоков в пуле фоновых потоков асинхронного загрузчика, выполняющих задачи
AsyncInsertCacheSize	Количество хеш-идентификаторов асинхронных вставок в кэше
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	Количество «пакетов» (наборов ключей) в очереди обновления 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	Количество активных запросов к источникам данных словарей типа cache
DiskObjectStorageAsyncThreads	Количество потоков в асинхронном пуле потоков DiskObjectStorage
DiskObjectStorageAsyncThreadsActive	Количество потоков в асинхронном пуле DiskObjectStorage, выполняющих задачу
DiskSpaceReservedForMerge	Место на диске, зарезервированное для выполняющихся фоновых слияний (слегка превышает совокупный размер объединяемых частей)
DistributedFilesToInsert	Количество файлов в очереди на обработку для асинхронной вставки в Distributed таблицы (суммарно по всем сегментам)
DistributedSend	Количество соединений с удалёнными серверами, отправляющими данные для INSERT в distributed таблицы (в синхронном и асинхронном режимах)
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	Количество потоков в пуле предвыборки ввода-вывода
IOPrefetchThreadsActive	Число потоков в пуле потоков предварительной выборки ввода-вывода, занятых выполнением задач
IOThreads	Количество потоков в пуле потоков ввода-вывода
IOThreadsActive	Количество потоков в пуле потоков ввода-вывода, занятых выполнением задач
IOUringInFlightEvents	Количество SQE io_uring, находящихся в обработке
IOUringPendingEvents	Количество элементов очереди io_uring (SQE), ожидающих отправки
IOWriterThreads	Количество потоков в пуле записи ввода-вывода
IOWriterThreadsActive	Количество потоков в пуле записи ввода-вывода, выполняющих задачу
InterserverConnection	Количество соединений от других реплик для загрузки частей
KafkaAssignedPartitions	Количество партиций Kafka, к которым в данный момент привязаны таблицы Kafka
KafkaBackgroundReads	Количество фоновых операций чтения, выполняющихся в данный момент (заполняющих materialized views из Kafka)
KafkaConsumers	Число активных консьюмеров Kafka
KafkaConsumersInUse	Количество консьюмеров, в данный момент задействованных для прямых и фоновых чтений
KafkaConsumersWithAssignment	Количество активных потребителей Kafka с назначенными партициями
KafkaLibrdkafkaThreads	Количество активных потоков в librdkafka
KafkaProducers	Количество активных продюсеров Kafka
KafkaWrites	Количество текущих операций вставки в Kafka
KeeperAliveConnections	Количество активных соединений
KeeperOutstandingRequests	Количество необработанных запросов
LocalThread	Количество потоков в локальных пулах потоков, выделенных из глобального пула потоков
LocalThreadActive	Количество потоков в локальных пулах потоков, выполняющих задачи
MMappedAllocBytes	Суммарный объём байт выделений через mmap
MMappedAllocs	Общее число выделений памяти через mmap
MMappedFileBytes	Суммарный размер участков файлов, отображённых в память
MMappedFiles	Общее количество файлов, отображённых в память (mmapped)
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; может быть удалена после их завершения
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, pread, io_getevents и т. д.), находящихся в обработке
ReadTaskRequestsSent	Текущее число активных запросов обратного вызова с удалённого сервера к инициатору для выбора задачи чтения (для s3Cluster и аналогичных случаев, измеряется на удалённом сервере)
ReadonlyReplica	Количество Replicated-таблиц в режиме только для чтения из-за повторной инициализации после потери сессии 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	Версия сервера в виде одного целого числа в системе счисления с основанием 1000 (например, 11.22.33 = 11022033)
Запись	Количество системных вызовов записи (write, pwrite, io_getevents и т. д.), выполняющихся в данный момент
ZooKeeperRequest	Количество одновременно обрабатываемых запросов к ZooKeeper
ZooKeeperSession	Количество сессий (подключений) к ZooKeeper (их не должно быть больше одной из‑за отсутствия линеаризуемости)
ZooKeeperWatch	Количество наблюдений (подписок на события) в ZooKeeper
ConcurrencyControlAcquired	Общее количество задействованных слотов CPU
ConcurrencyControlSoftLimit	Значение мягкого лимита на число CPU-слотов

См. также

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

Описание метрик​

Описание метрик