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	비동기 로더 포그라운드 스레드 풀의 스레드 수
TablesLoaderForegroundThreadsActive	작업을 실행 중인 비동기 로더 포그라운드 스레드 풀 스레드 수
TablesLoaderBackgroundThreads	비동기 로더 백그라운드 스레드 풀의 스레드 수
TablesLoaderBackgroundThreadsActive	작업을 실행 중인 비동기 로더 백그라운드 스레드 풀 스레드 수
AsyncInsertCacheSize	캐시에 있는 비동기 insert 해시 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	MOVE 작업용 BackgroundProcessingPool에서의 작업 수 제한
BackgroundMovePoolTask	MOVE 작업용 BackgroundProcessingPool에서 활성 상태인 작업 수
BackgroundSchedulePoolSize	BackgroundSchedulePool에서의 작업 수 제한(이전 데이터 파트 정리, 데이터 파트 변경, 레플리카 재초기화와 같은 주기적인 ReplicatedMergeTree 작업에 사용)
BackgroundSchedulePoolTask	BackgroundSchedulePool에서 활성 상태인 작업 수(이전 데이터 파트 정리, 데이터 파트 변경, 레플리카 재초기화와 같은 주기적인 ReplicatedMergeTree 작업에 사용)
BackupsIOThreads	BackupsIO 스레드 풀의 스레드 수
BackupsIOThreadsActive	작업을 실행 중인 BackupsIO 스레드 풀 스레드 수
BackupsThreads	BACKUP용 스레드 풀의 스레드 수
BackupsThreadsActive	작업을 실행 중인 BACKUP용 스레드 풀 스레드 수
BrokenDistributedFilesToInsert	분산 테이블에 대한 비동기 삽입용 파일 중 손상된 것으로 표시된 파일 수(0부터 시작하며 세그먼트별 합계)
CacheDetachedFileSegments	분리(detach)된 캐시 파일 세그먼트의 총 개수
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 테이블에서 특정 파티션에 활성 데이터 파트가 너무 많아 제한(throttle)된 INSERT 쿼리 수
DestroyAggregatesThreads	집계 상태를 소멸(destroy)하기 위한 스레드 풀의 스레드 수
DestroyAggregatesThreadsActive	집계 상태를 소멸(destroy)하기 위한 스레드 풀에서 작업을 실행 중인 스레드 수
DictCacheRequests	캐시 타입 딕셔너리의 데이터 소스로 전송 중(in flight)인 요청 수
DiskObjectStorageAsyncThreads	DiskObjectStorage용 비동기 스레드 풀의 스레드 수
DiskObjectStorageAsyncThreadsActive	작업을 실행 중인 DiskObjectStorage용 비동기 스레드 풀의 스레드 수
DiskSpaceReservedForMerge	현재 실행 중인 백그라운드 머지 작업을 위해 예약된 디스크 공간(머지되는 전체 파트 크기보다 약간 큼)
DistributedFilesToInsert	분산 테이블에 대한 비동기 삽입을 위해 처리 대기 중인 파일 수(세그먼트별 합계)
DistributedSend	분산 테이블로 INSERT된 데이터를 전송하는 원격 서버와의 연결 수(동기 및 비동기 모드 포함)
EphemeralNode	ZooKeeper에 유지되고 있는 임시(ephemeral) 노드 수
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 writer 스레드 풀의 스레드 수
InterserverConnection	다른 레플리카에서 파트를 가져오기 위한 연결 수
KafkaAssignedPartitions	현재 Kafka 테이블에 할당된 파티션 수
KafkaBackgroundReads	현재 동작 중인 백그라운드 읽기 작업 수(Kafka에서 materialized view를 채우는 작업)
KafkaConsumers	활성 Kafka 컨슈머 수
KafkaConsumersInUse	직접 읽기 또는 백그라운드 읽기에 현재 사용 중인 컨슈머 수
KafkaConsumersWithAssignment	파티션이 할당된 활성 Kafka 컨슈머 수
KafkaLibrdkafkaThreads	활성 librdkafka 스레드 수
KafkaProducers	생성된 활성 Kafka 프로듀서 수
KafkaWrites	현재 실행 중인 Kafka로의 INSERT 작업 수
KeeperAliveConnections	활성(alive) 연결 수
KeeperOutstandingRequests	미처리(outstanding) 요청 수
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 테이블에 적용됨)
MergeTreeBackgroundExecutorThreads	MergeTreeBackgroundExecutor 스레드 풀의 스레드 수
MergeTreeBackgroundExecutorThreadsActive	작업을 실행 중인 MergeTreeBackgroundExecutor 스레드 풀의 스레드 수
MergeTreeDataSelectExecutorThreads	MergeTreeDataSelectExecutor 스레드 풀의 스레드 수
MergeTreeDataSelectExecutorThreadsActive	작업을 실행 중인 MergeTreeDataSelectExecutor 스레드 풀의 스레드 수
MergeTreePartsCleanerThreads	MergeTree 파트 정리기(parts cleaner) 스레드 풀의 스레드 수
MergeTreePartsCleanerThreadsActive	작업을 실행 중인 MergeTree 파트 정리기(parts cleaner) 스레드 풀의 스레드 수
MergeTreePartsLoaderThreads	MergeTree 파트 로더(parts loader) 스레드 풀의 스레드 수
MergeTreePartsLoaderThreadsActive	작업을 실행 중인 MergeTree 파트 로더(parts loader) 스레드 풀의 스레드 수
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	Compact 파트 수
PartsDeleteOnDestroy	다른 디스크로 이동되었으며 자체 소멸자에서 삭제되어야 하는 파트 수
PartsDeleting	식별용 refcounter를 가진 비활성 데이터 파트로, 정리기(cleaner)가 현재 삭제 중인 파트 수
PartsOutdated	비활성 데이터 파트이지만 현재 SELECT에서만 사용될 수 있으며, 해당 SELECT가 끝난 후 삭제될 수 있는 파트 수
PartsPreActive	data_parts에는 존재하지만 SELECT에서는 사용되지 않는 파트 수
PartsPreCommitted	사용이 중단되었습니다. PartsPreActive를 참조하십시오.
PartsTemporary	현재 생성 중이며 data_parts 목록에는 포함되지 않은 파트 수
PartsWide	Wide 파트 수
PendingAsyncInsert	플러시를 대기 중인 비동기 insert 작업 수
PostgreSQLConnection	PostgreSQL 프로토콜을 사용하는 클라이언트 연결 수
쿼리	실행 중인 쿼리 수
QueryPreempted	「priority」 설정으로 인해 일시 중지되어 대기 중인 쿼리 수
QueryThread	쿼리 처리 스레드 수
RWLockActiveReaders	테이블 RWLock에서 읽기 잠금을 보유 중인 스레드 수
RWLockActiveWriters	테이블 RWLock에서 쓰기 잠금을 보유 중인 스레드 수
RWLockWaitingReaders	테이블 RWLock에서 읽기를 대기 중인 스레드 수
RWLockWaitingWriters	테이블 RWLock에서 쓰기를 대기 중인 스레드 수
Read	진행 중인 read, pread, io_getevents 등의 시스템 호출(syscall) 수
ReadTaskRequestsSent	원격 서버에서 이니시에이터로 읽기 작업을 선택하도록 전송되는 콜백 요청(예: s3Cluster 등; 원격 서버 기준으로 측정)의 현재 진행 중인 수
ReadonlyReplica	ZooKeeper 세션 손실 후 재초기화되었거나 ZooKeeper 미구성 상태에서 시작되어 읽기 전용 상태가 된 복제된 테이블(Replicated Table) 개수
RemoteRead	원격 리더(remote reader)를 사용한 진행 중인 읽기 수
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 테이블 버퍼에 있는 행(row) 수
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 등) 시스템 호출(syscall) 수
ZooKeeperRequest	진행 중인 ZooKeeper 요청 수
ZooKeeperSession	ZooKeeper에 대한 세션(연결) 수 (선형화 가능성이 없으므로 1을 넘지 않아야 함)
ZooKeeperWatch	ZooKeeper의 watch(이벤트 구독) 수
ConcurrencyControlAcquired	획득된 CPU 슬롯의 총 수
ConcurrencyControlSoftLimit	CPU 슬롯 수에 대한 소프트 제한값

관련 항목

system.asynchronous_metrics — 주기적으로 계산되는 메트릭을 포함합니다.
system.events — 발생한 여러 이벤트를 포함합니다.
system.metric_log — system.metrics 및 system.events 테이블의 메트릭 값 이력을 포함합니다.
Monitoring — ClickHouse 모니터링의 기본 개념을 설명합니다.

메트릭 설명​

메트릭 설명