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

system.metrics

Выполнение запросов в ClickHouse Cloud

Данные в этой системной таблице хранятся локально на каждом узле в ClickHouse Cloud. Поэтому для получения полного обзора всех данных требуется функция clusterAllReplicas. Подробности см. здесь.

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

Столбцы:

Все поддерживаемые метрики перечислены в файле исходного кода 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​

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

TablesLoaderBackgroundThreads​

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

TablesLoaderBackgroundThreadsActive​

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

AsyncInsertCacheSize​

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

AsynchronousInsertThreads​

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

AsynchronousInsertThreadsActive​

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

AsynchronousReadWait​

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

BackgroundBufferFlushSchedulePoolSize​

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

BackgroundBufferFlushSchedulePoolTask​

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

BackgroundCommonPoolSize​

Ограничение количества задач в соответствующем фоновом пуле

BackgroundCommonPoolTask​

Количество активных задач в соответствующем фоновом пуле

BackgroundDistributedSchedulePoolSize​

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

BackgroundDistributedSchedulePoolTask​

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

BackgroundFetchesPoolSize​

Лимит количества одновременных операций выборки в связанном фоновом пуле

BackgroundFetchesPoolTask​

Количество активных операций выборки в связанном фоновом пуле

BackgroundMergesAndMutationsPoolSize​

Ограничение числа активных слияний и мутаций в соответствующем фоновом пуле

BackgroundMergesAndMutationsPoolTask​

Количество активных слияний и мутаций в связанном фоновом пуле

BackgroundMessageBrokerSchedulePoolSize​

Ограничение числа задач в BackgroundProcessingPool для стриминга сообщений

BackgroundMessageBrokerSchedulePoolTask​

Количество активных задач в BackgroundProcessingPool для стриминга сообщений

BackgroundMovePoolSize​

Ограничение на число задач в BackgroundProcessingPool для операций перемещения

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, выполняющих задачи.

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​

Количество подключений к удалённым серверам для отправки данных, вставленных оператором INSERT в таблицы 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​

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

IOPrefetchThreadsActive​

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

IOThreads​

Количество потоков в пуле потоков ввода/вывода.

IOThreadsActive​

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

IOUringInFlightEvents​

Количество активных SQE io_uring

IOUringPendingEvents​

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

IOWriterThreads​

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

IOWriterThreadsActive​

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

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​

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

MMappedFiles​

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

MarksLoaderThreads​

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

MarksLoaderThreadsActive​

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

MaxDDLEntryID​

Идентификатор последней обработанной записи DDL для DDLWorker.

MaxPushedDDLEntryID​

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

MemoryTracking​

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

Слияние​

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

MergeTreeAllRangesAnnouncementsSent​

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

MergeTreeBackgroundExecutorThreads​

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

MergeTreeBackgroundExecutorThreadsActive​

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

MergeTreeDataSelectExecutorThreads​

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

MergeTreeDataSelectExecutorThreadsActive​

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

MergeTreePartsCleanerThreads​

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

MergeTreePartsCleanerThreadsActive​

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

MergeTreePartsLoaderThreads​

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

MergeTreePartsLoaderThreadsActive​

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

MergeTreeReadTaskRequestsSent​

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

Перемещения​

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

MySQLConnection​

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

NetworkReceive​

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

NetworkSend​

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

OpenFileForRead​

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

OpenFileForWrite​

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

ParallelFormattingOutputFormatThreads​

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

ParallelFormattingOutputFormatThreadsActive​

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

PartMutation​

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

PartsActive​

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

PartsCommitted​

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

PartsCompact​

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

PartsDeleteOnDestroy​

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

PartsDeleting​

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

PartsOutdated​

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

PartsPreActive​

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

PartsPreCommitted​

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

PartsTemporary​

Часть находится в процессе создания, её нет в списке data_parts.

PartsWide​

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

PendingAsyncInsert​

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

PostgreSQLConnection​

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

Query​

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

QueryPreempted​

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

QueryThread​

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

RWLockActiveReaders​

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

RWLockActiveWriters​

Количество потоков, удерживающих блокировку на запись (write lock) в 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 для выполнения задачи.

Ревизия​

Ревизия сервера. Это число, которое увеличивается с каждым релизом или релиз-кандидатом, за исключением патч-релизов.

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, pwrite, io_getevents и т. д.)

ZooKeeperRequest​

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

ZooKeeperSession​

Количество сессий (соединений) с ZooKeeper не должно превышать одной, поскольку использование более чем одного соединения с ZooKeeper может приводить к ошибкам из‑за отсутствия линеаризуемости (устаревших чтений), допускаемого моделью согласованности ZooKeeper.

ZooKeeperWatch​

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

ConcurrencyControlAcquired​

Общее количество выделенных слотов CPU.

ConcurrencyControlSoftLimit​

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

См. также

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