system.asynchronous_metrics

백그라운드에서 주기적으로 계산되는 메트릭이 포함된 시스템 테이블입니다. 예를 들어, 현재 사용 중인 RAM 용량이 있습니다.

ClickHouse Cloud에서 쿼리하기

이 시스템 테이블의 데이터는 ClickHouse Cloud의 각 노드에 로컬로 저장됩니다. 따라서 전체 데이터를 모두 확인하려면 clusterAllReplicas 함수를 사용해야 합니다. 자세한 내용은 여기를 참조하십시오.

​

설명

백그라운드에서 주기적으로 계산되는 메트릭을 포함합니다. 예를 들어, 현재 사용 중인 RAM 용량입니다.

​

컬럼

• metric (String) — 메트릭 이름.
• value (Float64) — 메트릭 값.
• description (String - 메트릭 설명)

​

예시

SELECT * FROM system.asynchronous_metrics LIMIT 10

┌─metric──────────────────────────────────┬──────value─┬─description────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ AsynchronousMetricsCalculationTimeSpent │ 0.00179053 │ Time in seconds spent for calculation of asynchronous metrics (this is the overhead of asynchronous metrics).                                                                                                                                              │
│ NumberOfDetachedByUserParts             │          0 │ The total number of parts detached from MergeTree tables by users with the `ALTER TABLE DETACH` query (as opposed to unexpected, broken or ignored parts). The server does not care about detached parts and they can be removed.                          │
│ NumberOfDetachedParts                   │          0 │ The total number of parts detached from MergeTree tables. A part can be detached by a user with the `ALTER TABLE DETACH` query or by the server itself it the part is broken, unexpected or unneeded. The server does not care about detached parts and they can be removed. │
│ TotalRowsOfMergeTreeTables              │    2781309 │ Total amount of rows (records) stored in all tables of MergeTree family.                                                                                                                                                                                   │
│ TotalBytesOfMergeTreeTables             │    7741926 │ Total amount of bytes (compressed, including data and indices) stored in all tables of MergeTree family.                                                                                                                                                   │
│ NumberOfTables                          │         93 │ Total number of tables summed across the databases on the server, excluding the databases that cannot contain MergeTree tables. The excluded database engines are those who generate the set of tables on the fly, like `Lazy`, `MySQL`, `PostgreSQL`, `SQlite`. │
│ NumberOfDatabases                       │          6 │ Total number of databases on the server.                                                                                                                                                                                                                   │
│ MaxPartCountForPartition                │          6 │ Maximum number of parts per partition across all partitions of all tables of MergeTree family. Values larger than 300 indicates misconfiguration, overload, or massive data loading.                                                                       │
│ ReplicasSumMergesInQueue                │          0 │ Sum of merge operations in the queue (still to be applied) across Replicated tables.                                                                                                                                                                       │
│ ReplicasSumInsertsInQueue               │          0 │ Sum of INSERT operations in the queue (still to be replicated) across Replicated tables.                                                                                                                                                                   │
└─────────────────────────────────────────┴────────────┴────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

​

메트릭 설명

아래 설명은 C++ 소스의 utils/generate-async-metrics-docs로 생성됩니다. 기준 원본은 src/Common/AsynchronousMetrics.cpp, src/Interpreters/ServerAsynchronousMetrics.cpp, src/Coordination/KeeperAsynchronousMetrics.cpp에서 각 메트릭 등록 옆에 있는 문자열 리터럴입니다. 가변 suffix(디스크별, CPU별, 인터페이스별, …)를 포함하는 메트릭 이름은 *name* 플레이스홀더로 표시되며, 실행 중인 server는 여기에 실제 suffix를 대입해 보고합니다.

​

AsynchronousHeavyMetricsCalculationTimeSpent

비동기식 고부하(테이블 관련) 메트릭 계산에 소요된 시간(초)입니다(비동기 메트릭의 오버헤드입니다).

​

AsynchronousHeavyMetricsUpdateInterval

부하가 큰(테이블 관련) 메트릭 업데이트 간격

​

AsynchronousMetricsCalculationTimeSpent

비동기 메트릭 계산에 소요되는 시간(초)입니다(즉, 비동기 메트릭으로 인한 오버헤드입니다).

​

AsynchronousMetricsUpdateInterval

메트릭 업데이트 주기

​

AsyncLoggingmetric_firstQueueSize

이 채널에서 로깅을 위해 대기열에 쌓여 있는 비동기 메시지 수

​

BlockActiveTime_name

블록 디바이스에서 IO 요청이 큐에 들어가 있던 시간을 초 단위로 나타냅니다. 이 메트릭은 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다. 소스: /sys/block. 자세한 내용은 https://www.kernel.org/doc/Documentation/block/stat.txt를 참조하십시오.

​

BlockActiveTimePerOp_name

BlockActiveTime 메트릭과 유사하지만, 작업별 시간을 계산할 수 있도록 값을 IO 작업 수로 나눕니다.

​

BlockDiscardBytes_name

블록 디바이스에서 폐기된 바이트 수입니다. 이러한 작업은 SSD와 관련이 있습니다. discard 작업은 ClickHouse에서는 사용되지 않지만, 시스템의 다른 프로세스에서 사용될 수 있습니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다. 소스: /sys/block. https://www.kernel.org/doc/Documentation/block/stat.txt를 참조하십시오.

​

BlockDiscardMerges_name

블록 디바이스에 요청된 discard 작업 중 OS IO 스케줄러가 함께 머지한 작업 수입니다. 이러한 작업은 SSD에서 중요합니다. discard 작업은 ClickHouse에서는 사용되지 않지만, 시스템의 다른 프로세스에서는 사용될 수 있습니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐 아니라 호스트 머신의 모든 프로세스를 포함합니다. 출처: /sys/block. 자세한 내용은 https://www.kernel.org/doc/Documentation/block/stat.txt 를 참조하십시오.

​

BlockDiscardOps_name

블록 디바이스에 요청된 discard 작업 수입니다. 이러한 작업은 SSD에서 의미가 있습니다. discard 작업은 ClickHouse에서는 사용하지 않지만, 시스템의 다른 프로세스에서는 사용할 수 있습니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐 아니라 호스트 머신의 모든 프로세스를 포함합니다. 출처: /sys/block. 자세한 내용은 https://www.kernel.org/doc/Documentation/block/stat.txt 를 참조하십시오.

​

BlockDiscardTime_name

블록 디바이스에 요청된 discard 작업에 소요된 시간을 초 단위로 나타내며, 모든 작업에 걸린 시간을 합산한 값입니다. 이러한 작업은 SSD와 관련이 있습니다. discard 작업은 ClickHouse에서 사용하지 않지만, 시스템의 다른 프로세스에서 사용할 수 있습니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐 아니라 호스트 머신의 모든 프로세스를 포함합니다. 소스: /sys/block. 자세한 내용은 https://www.kernel.org/doc/Documentation/block/stat.txt 를 참조하십시오.

​

BlockInFlightOps_name

이 값은 장치 드라이버에 전달되었지만 아직 완료되지 않은 I/O 요청 수를 나타냅니다. 큐에 들어 있지만 아직 장치 드라이버에 전달되지 않은 I/O 요청은 포함하지 않습니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다. 출처: /sys/block. 자세한 내용은 https://www.kernel.org/doc/Documentation/block/stat.txt 를 참조하십시오.

​

BlockQueueTime_name

이 값은 이 블록 디바이스에서 IO 요청이 대기한 시간을 밀리초 단위로 집계합니다. 대기 중인 IO 요청이 여러 개이면, 이 값은 대기 시간(밀리초)과 대기 중인 요청 수의 곱만큼 증가합니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다. 출처: /sys/block. 자세한 내용은 https://www.kernel.org/doc/Documentation/block/stat.txt 를 참조하십시오.

​

BlockQueueTimePerOp_name

BlockQueueTime 메트릭과 유사하지만, 작업당 시간을 계산할 수 있도록 값을 IO 작업 수로 나눕니다.

​

BlockReadBytes_name

블록 디바이스에서 읽은 바이트 수입니다. I/O를 절감하는 OS 페이지 캐시를 사용하므로 파일 시스템에서 읽은 바이트 수보다 적을 수 있습니다. 이는 시스템 전체 메트릭으로, clickhouse-server만이 아니라 호스트 머신의 모든 프로세스를 포함합니다. 소스: /sys/block. 자세한 내용은 https://www.kernel.org/doc/Documentation/block/stat.txt 를 참조하십시오.

​

BlockReadMerges_name

블록 디바이스에서 요청된 읽기 작업 중 OS IO 스케줄러에 의해 함께 머지된 작업 수입니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다. 출처: /sys/block. 자세한 내용은 https://www.kernel.org/doc/Documentation/block/stat.txt 를 참조하십시오.

​

BlockReadOps_name

블록 디바이스에 요청된 읽기 작업 수입니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다. 출처: /sys/block. 자세한 내용은 https://www.kernel.org/doc/Documentation/block/stat.txt 를 참조하십시오.

​

BlockReadTime_name

블록 디바이스에 요청된 읽기 작업에 소요된 시간을 초 단위로 나타내며, 모든 작업에 대해 합산한 값입니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다. 소스: /sys/block. https://www.kernel.org/doc/Documentation/block/stat.txt를 참조하십시오.

​

BlockWriteBytes_name

블록 디바이스에 기록된 바이트 수입니다. IO를 절약하는 OS 페이지 캐시를 사용하므로 파일 시스템에 기록된 바이트 수보다 적을 수 있습니다. write-through 캐싱으로 인해 블록 디바이스에 대한 쓰기는 해당 파일 시스템 쓰기보다 나중에 발생할 수 있습니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐 아니라 호스트 머신의 모든 프로세스를 포함합니다. 출처: /sys/block. 자세한 내용은 https://www.kernel.org/doc/Documentation/block/stat.txt를 참조하십시오.

​

BlockWriteMerges_name

블록 디바이스에 대해 요청되었고 OS IO 스케줄러에 의해 함께 머지된 쓰기 작업의 수입니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다. 출처: /sys/block. 자세한 내용은 https://www.kernel.org/doc/Documentation/block/stat.txt 를 참조하십시오.

​

BlockWriteOps_name

블록 디바이스에 요청된 쓰기 작업의 수입니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다. 출처: /sys/block. 자세한 내용은 https://www.kernel.org/doc/Documentation/block/stat.txt 를 참조하십시오.

​

BlockWriteTime_name

블록 디바이스에 요청된 쓰기 작업에 소요된 시간을 초 단위로 나타낸 값으로, 모든 작업의 시간을 합산한 것입니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다. 소스: /sys/block. 자세한 내용은 https://www.kernel.org/doc/Documentation/block/stat.txt 를 참조하십시오.

​

CGroupMaxCPU

CGroups 기준 최대 CPU 코어 수입니다.

​

CGroupMemoryTotal

cgroup의 총 메모리 용량을 바이트 단위로 나타냅니다. 값이 0이면 제한값은 OSMemoryTotal과 동일합니다.

​

CGroupMemoryUsed

cgroup에서 사용 중인 메모리의 양으로, 바이트 단위입니다. cgroup v2에서는 anon + sock + 회수할 수 없는 커널 메모리를 의미하며, cgroup v1에서는 RSS를 의미합니다. 두 경우 모두 커널의 OS 페이지 캐시(파일 기반 캐시)는 제외됩니다.

​

CGroupMemoryUsedWithoutPageCache

cgroup에서 사용 중인 메모리 양을 바이트 단위로 나타낸 값이며, ClickHouse 사용자 공간 페이지 캐시는 제외됩니다. 이 값은 CGroupMemoryUsed에서 사용자 공간 페이지 캐시 크기를 뺀 값입니다. 사용자 공간 페이지 캐시가 비활성화되어 있으면 이 값은 CGroupMemoryUsed와 같습니다.

​

CGroupSystemTime

CPU 코어가 OS 커널(system) 코드를 실행 중이었던 시간의 비율입니다.

​

CGroupSystemTimeNormalized

이 값은 CGroupSystemTime과 유사하지만, 코어 수와 관계없이 [0..1] 인터벌에서 측정할 수 있도록 사용 가능한 CPU 코어 수로 나눈 값입니다. 따라서 클러스터의 여러 서버에서 코어 수가 균등하지 않더라도 이 메트릭 값을 평균낼 수 있으며, 여전히 평균 리소스 사용률 메트릭을 얻을 수 있습니다. 지정된 경우 실제 CPU 코어 수 대신 Cgroup CPU quota를 해당 주기로 나눈 값을 사용할 수 있으며, 이 경우에는 이 메트릭 값이 일부 시점에서 1을 초과할 수 있습니다.

​

CGroupUserTime

CPU 코어가 사용자 공간 코드를 실행한 시간의 비율입니다. 또한 메모리 로드, 파이프라인 스톨, 브랜치 예측 실패, 다른 SMT 코어 실행 등 CPU 내부 요인으로 인해 CPU 활용도가 낮았던 시간도 포함됩니다.

​

CGroupUserTimeNormalized

이 값은 CGroupUserTime과 유사하지만, 코어 수와 관계없이 [0..1] 인터벌 범위에서 측정할 수 있도록 사용 가능한 CPU 코어 수로 나눈 값입니다. 따라서 코어 수가 균등하지 않더라도 cluster 내 여러 server에서 이 메트릭 값을 평균내어 평균 리소스 사용률 메트릭을 구할 수 있습니다. 지정된 경우 실제 CPU 코어 수 대신 주기로 나눈 Cgroup CPU quota를 사용할 수 있으며, 이 경우에는 일부 시점에서 이 메트릭 값이 1을 초과할 수 있습니다.

​

CPUFrequencyMHz_core_id

현재 CPU의 주파수이며, 단위는 MHz입니다. 최신 CPU의 대부분은 절전 및 Turbo Boost를 위해 주파수를 동적으로 조정합니다.

​

DictionaryMaxUpdateDelay

딕셔너리 업데이트의 최대 지연 시간(초 단위)입니다

​

DictionaryTotalFailedUpdates

모든 딕셔너리에서 마지막으로 로딩에 성공한 후 발생한 오류 수입니다.

​

DiskAvailable_name

디스크(가상 파일 시스템)에서 사용 가능한 바이트 수입니다. 원격 파일 시스템은 이 정보를 제공하지 않을 수 있으며, 16 EiB처럼 매우 큰 값으로 표시될 수 있습니다.

​

DiskGetObjectThrottlerAvailable_name

디스크(가상 파일 시스템)에서 스로틀링 한도에 걸리지 않고 현재 전송할 수 있는 GetObject 요청 수입니다. 로컬 파일 시스템은 이 정보를 제공하지 않을 수 있습니다.

​

DiskGetObjectThrottlerRPS_name

디스크의 GetObject 요청 스로틀링 한도(초당 요청 수, 가상 파일 시스템)입니다. 로컬 파일 시스템은 이 정보를 제공하지 않을 수 있습니다.

​

DiskPutObjectThrottlerAvailable_name

디스크(가상 파일 시스템)에서 스로틀링 한도에 걸리지 않고 현재 전송할 수 있는 PutObject 요청 수입니다. 로컬 파일 시스템은 이 정보를 제공하지 않을 수 있습니다.

​

DiskPutObjectThrottlerRPS_name

디스크의 PutObject 요청 스로틀링 한도이며, 단위는 초당 요청 수입니다(가상 파일 시스템). 로컬 파일 시스템은 이 정보를 제공하지 않을 수 있습니다.

​

DiskTotal_name

디스크(가상 파일 시스템)의 전체 크기를 바이트 단위로 나타냅니다. 원격 파일 시스템은 이 정보를 제공하지 않을 수 있으며, 16 EiB처럼 매우 큰 값으로 표시될 수 있습니다.

​

DiskUnreserved_name

머지, fetch, 이동 작업 예약분을 제외한 디스크(가상 파일 시스템)의 사용 가능 바이트 수입니다. 원격 파일 시스템은 이 정보를 제공하지 않을 수 있으며 16 EiB처럼 매우 큰 값을 표시할 수 있습니다.

​

DiskUsed_name

디스크(가상 파일 시스템)에서 사용된 바이트 수입니다. 원격 파일 시스템은 이 정보를 항상 제공하는 것은 아닙니다.

​

EDACi_Correctable

수정 가능한 ECC 메모리 오류 수입니다. 이 값이 높으면 RAM에 문제가 있음을 의미하며, 즉시 교체해야 합니다. 수정된 오류가 많이 발생하면 무증상 오류도 함께 발생해 데이터 손상으로 이어질 수 있기 때문입니다. 출처: /sys/devices/system/edac/mc/

​

EDACi_Uncorrectable

수정할 수 없는 ECC 메모리 오류의 개수입니다. 이 값이 0이 아니면 RAM에 결함이 있음을 의미하며, 잠재적인 데이터 손상을 나타내므로 즉시 교체해야 합니다. 출처: /sys/devices/system/edac/mc/

​

FilesystemCacheBytes

cache 가상 파일 시스템의 총 바이트 수입니다. 이 캐시는 디스크에 저장됩니다.

​

FilesystemCacheCapacity

cache 가상 파일 시스템의 총 용량입니다. 이 캐시는 디스크에 저장됩니다.

​

FilesystemCacheFiles

cache 가상 파일 시스템의 캐시된 파일 세그먼트 총개수입니다. 이 캐시는 디스크에 저장됩니다.

​

FilesystemLogsPathAvailableBytes

ClickHouse 로그 경로가 마운트되어 있는 볼륨에서 사용 가능한 바이트 수입니다. 이 값이 0에 가까워지면 설정 파일에서 로그 로테이션을 조정해야 합니다.

​

FilesystemLogsPathAvailableINodes

ClickHouse 로그 경로가 마운트된 볼륨에서 사용 가능한 inode 수입니다.

​

FilesystemLogsPathTotalBytes

ClickHouse 로그 경로가 마운트된 볼륨의 크기(바이트)입니다. 로그용으로는 최소 10 GB를 확보하는 것이 좋습니다.

​

FilesystemLogsPathTotalINodes

ClickHouse 로그 경로가 마운트된 볼륨의 전체 inode 수입니다.

​

FilesystemLogsPathUsedBytes

ClickHouse 로그 경로가 마운트된 볼륨에서 사용 중인 바이트 수입니다.

​

FilesystemLogsPathUsedINodes

ClickHouse 로그 경로가 마운트된 볼륨에서 사용 중인 inode 수입니다.

​

FilesystemMainPathAvailableBytes

기본 ClickHouse 경로가 마운트된 볼륨에서 사용 가능한 바이트 수입니다.

​

FilesystemMainPathAvailableINodes

기본 ClickHouse 경로가 마운트된 볼륨에서 사용할 수 있는 inode 수입니다. 이 값이 0에 가까우면 구성이 잘못되었을 수 있으며, 디스크가 가득 차지 않았더라도 ‘no space left on device’ 오류가 발생할 수 있습니다.

​

FilesystemMainPathTotalBytes

기본 ClickHouse 경로가 마운트된 볼륨의 크기(바이트)입니다.

​

FilesystemMainPathTotalINodes

기본 ClickHouse 경로가 마운트된 볼륨의 전체 inode 수를 나타냅니다. 이 값이 2,500만 미만이면 구성 오류를 의미합니다.

​

FilesystemMainPathUsedBytes

기본 ClickHouse 경로가 마운트된 볼륨에서 사용 중인 바이트 수입니다.

​

FilesystemMainPathUsedINodes

기본 ClickHouse 경로가 마운트된 볼륨에서 사용 중인 inode 수입니다. 이 값은 대부분 파일 수에 해당합니다.

​

GRPCRejectedConnections

GRPC 프로토콜에서 거부된 연결 수입니다.

​

GRPCThreads

GRPC 프로토콜 서버의 스레드 수입니다.

​

HashTableStatsCacheEntries

해시 테이블 크기 캐시에 저장된 항목 수입니다. 해시 테이블 크기 캐시는 GROUP BY의 예측 최적화에 사용됩니다.

​

HashTableStatsCacheHits

해시 테이블 크기 예측이 정확하게 맞은 횟수입니다.

​

HashTableStatsCacheMisses

해시 테이블 크기 예측이 빗나간 횟수입니다.

​

HTTPConnectionPoolgroup_nameTCPRcvBufTotalBytes

HTTP 연결 풀의 모든 소켓에 걸친 커널 TCP 수신 버퍼 메모리(sk_rmem_alloc) 총합입니다.

​

HTTPConnectionPoolgroup_nameTCPSndBufTotalBytes

모든 HTTP 연결 풀 소켓에서 사용 중인 커널 TCP 송신 버퍼 메모리(sk_wmem_alloc)의 총량입니다.

​

HTTPRejectedConnections

HTTP 인터페이스(TLS 제외)에서 거부된 연결 수입니다.

​

HTTPSecureRejectedConnections

HTTPS 인터페이스에서 거부된 연결 수입니다.

​

HTTPSecureThreads

HTTPS 인터페이스 서버에서 사용되는 스레드 수입니다.

​

HTTPThreads

TLS를 사용하지 않는 HTTP 인터페이스 서버의 스레드 수입니다.

​

InterserverRejectedConnections

TLS를 사용하지 않는 레플리카 간 통신 프로토콜에서 거부된 연결 수입니다.

​

InterserverSecureRejectedConnections

TLS를 사용하는 레플리카 간 통신 프로토콜에서 거부된 연결 수입니다.

​

InterserverSecureThreads

TLS를 사용하는 레플리카 통신 프로토콜 서버의 스레드 수입니다.

​

InterserverThreads

TLS를 사용하지 않는 레플리카 간 통신 프로토콜의 서버 스레드 수입니다.

​

jemalloc.active

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. 자세한 내용은 https://jemalloc.net/jemalloc.3.html 를 참조하십시오.

​

jemalloc.allocated

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. 자세한 내용은 https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.arenas.all.dirty_purged

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. 자세한 내용은 https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.arenas.all.muzzy_purged

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. 자세한 내용은 https://jemalloc.net/jemalloc.3.html 을 참조하십시오.

​

jemalloc.arenas.all.pactive

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. 자세한 내용은 https://jemalloc.net/jemalloc.3.html를 참조하십시오.

​

jemalloc.arenas.all.pdirty

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. 자세한 내용은 https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.arenas.all.pmuzzy

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. 자세한 내용은 https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.arenas.dirty_decay_ms

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.background_thread.num_runs

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. 자세한 내용은 https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.background_thread.num_threads

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. 자세한 내용은 https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.background_thread.run_intervals

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. 자세한 내용은 https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.cache_arena.pactive

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.cache_arena.pdirty

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.epoch

jemalloc(Jason Evans의 메모리 할당자) 통계의 내부 증분 업데이트 번호로, 다른 모든 jemalloc 메트릭에서 사용됩니다.

​

jemalloc.mapped

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. 자세한 내용은 https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.mergetree_arena.active_bytes

전용 jemalloc MergeTree 아레나의 활성 바이트 수입니다. 장기간 유지되는 MergeTree 힙 상태를 담고 있습니다. 여기에는 파트별 메타데이터(NamesAndTypesList, SerializationInfoByName, serializations 맵, column_name_to_position, MergeTreeDataPartChecksums 트리, 각 IMergeTreeDataPart 내부의 Poco::LRUCache<String, ColumnSize> 델리게이트, 파트별 ColumnSize/IndexSize 맵, MinMaxIndex, VersionMetadataOnDisk, 그리고 MergeTreeDataPart{Compact,Wide} 객체 자체)와 테이블별 메타데이터(setProperties로 설정되는 StorageInMemoryMetadata / ColumnsDescription / VirtualColumnsDescription 복제본, serialization_hints 집계, 그리고 columns_descriptions_cache)가 포함됩니다. 활성 파트와 정리 대기 중인 오래된 파트가 모두 여기에 포함됩니다. 이는 cache 아레나 및 JIT 아레나와 서로 분리되어 있습니다. 파트별 컬럼 system.parts.primary_key_bytes_in_memory[_allocated] 및 system.parts.index_granularity_bytes_in_memory[_allocated]은 이 메트릭의 부분 집합입니다(값이 0이 아닐 경우 기준 — 이 값들은 대신 PrimaryIndexCacheBytes에 있을 수도 있으며, 이 경우 cache 아레나에 있으므로 여기에는 포함되지 않습니다).

​

jemalloc.mergetree_arena.dirty_bytes

OS에 다시 반환할 수 있도록 퍼지 가능한 MergeTree 아레나의 더티 바이트 수입니다.

​

jemalloc.mergetree_arena.pactive

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.mergetree_arena.pdirty

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.metadata

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. 자세한 내용은 https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.metadata_thp

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. 자세한 내용은 https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.prof.active

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.prof.lg_sample

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.prof.thread_active_init

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.resident

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. 자세한 내용은 https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

jemalloc.retained

저수준 메모리 할당자(jemalloc)의 내부 메트릭입니다. 자세한 내용은 https://jemalloc.net/jemalloc.3.html을 참조하십시오.

​

지터

비동기 메트릭을 계산하는 스레드가 깨어나기로 예약된 시각과 실제로 깨어난 시각 사이의 시간 차이입니다. 전체 시스템의 지연 시간과 응답성을 간접적으로 보여주는 지표입니다.

​

KeeperApproximateDataSize

ClickHouse Keeper의 대략적인 데이터 크기이며, 단위는 바이트입니다.

​

KeeperAvgLatency

ClickHouse Keeper의 평균 요청 지연 시간.

​

KeeperCommitLogsCacheEntries

다음에 커밋될 로그에 대해 인메모리 캐시에 저장된 항목 수

​

KeeperCommitLogsCacheSize

다음에 커밋될 로그를 저장하는 인메모리 캐시의 전체 크기

​

KeeperEphemeralsCount

ClickHouse Keeper의 ephemeral 노드 수입니다.

​

KeeperFollowers

ClickHouse Keeper의 팔로워 수입니다.

​

KeeperIsExceedingMemorySoftLimitHit

ClickHouse Keeper가 메모리 소프트 리밋을 초과한 경우 1, 그렇지 않으면 0입니다.

​

KeeperIsFollower

ClickHouse Keeper가 팔로워인 경우 1, 아니면 0입니다.

​

KeeperIsLeader

ClickHouse Keeper가 leader이면 1이고, 그렇지 않으면 0입니다.

​

KeeperIsObserver

ClickHouse Keeper가 옵저버이면 1, 아니면 0입니다.

​

KeeperIsStandalone

ClickHouse Keeper가 standalone 모드인 경우 1, 그렇지 않으면 0입니다.

​

KeeperKeyArenaSize

ClickHouse Keeper에서 키의 메모리 아레나 크기를 바이트 단위로 나타냅니다.

​

KeeperLastCommittedLogIdx

ClickHouse Keeper에서 마지막으로 커밋된 로그의 인덱스입니다.

​

KeeperLastLogIdx

ClickHouse Keeper에 저장된 마지막 로그 항목의 인덱스입니다.

​

KeeperLastLogTerm

ClickHouse Keeper에 저장된 마지막 로그의 Raft 임기입니다.

​

KeeperLastSnapshotIdx

가장 최근에 생성된 스냅샷에 포함된 마지막 로그의 인덱스입니다.

​

KeeperLatestLogsCacheEntries

최신 로그용 인메모리 캐시에 저장된 항목 수

​

KeeperLatestLogsCacheSize

최신 로그용 인메모리 캐시의 총 크기

​

KeeperLatestSnapshotSize

ClickHouse Keeper가 생성한 최신 스냅샷의 압축되지 않은 크기(바이트)입니다.

​

KeeperMaxFileDescriptorCount

ClickHouse Keeper에서 열려 있는 파일 디스크립터의 최대 개수입니다.

​

KeeperMaxLatency

ClickHouse Keeper의 요청 최대 지연 시간입니다.

​

KeeperMinLatency

ClickHouse Keeper 요청의 최소 지연 시간입니다.

​

KeeperOpenFileDescriptorCount

ClickHouse Keeper에서 열린 파일 디스크립터의 수입니다.

​

KeeperPacketsReceived

ClickHouse Keeper에서 수신한 패킷 수입니다.

​

KeeperPacketsSent

ClickHouse Keeper가 전송한 패킷 수입니다.

​

KeeperPathsWatched

ClickHouse Keeper의 클라이언트가 watch를 설정한 서로 다른 경로 수입니다.

​

KeeperSessionWithWatches

watch가 설정된 ClickHouse Keeper의 클라이언트 세션 수입니다.

​

KeeperSyncedFollowers

ClickHouse Keeper에서 동기화 상태인 팔로워의 수입니다.

​

KeeperTargetCommitLogIdx

ClickHouse Keeper에서 로그를 커밋할 수 있는 최대 인덱스입니다.

​

KeeperTCPRejectedConnections

Keeper TCP 프로토콜(TLS 미사용)에서 거부된 연결 수입니다.

​

KeeperTCPSecureRejectedConnections

TLS를 사용하는 Keeper TCP 프로토콜에서 거부된 연결 수입니다.

​

KeeperTCPSecureThreads

TLS를 사용하는 Keeper TCP 프로토콜 서버의 스레드 수입니다.

​

KeeperTCPThreads

TLS 없이 사용하는 Keeper TCP 프로토콜 서버의 스레드 수입니다.

​

KeeperWatchCount

ClickHouse Keeper의 watch 개수입니다.

​

KeeperZnodeCount

ClickHouse Keeper의 노드 수(데이터 항목 수)입니다.

​

KeeperZxid

ClickHouse Keeper의 현재 트랜잭션 ID 번호(zxid)입니다.

​

LoadAverage1

전체 시스템 부하를 1분 동안 지수 평활(exponential smoothing)하여 평균낸 값입니다. 이 부하는 현재 CPU에서 실행 중이거나 IO를 기다리고 있거나, 실행할 준비가 되었지만 현재 시점에는 스케줄링되지 않은 모든 프로세스의 스레드 수(OS 커널의 스케줄링 엔터티)를 나타냅니다. 이 수치에는 clickhouse-server만이 아니라 모든 프로세스가 포함됩니다. 시스템에 과부하가 걸려 실행 준비 상태인 프로세스가 많지만 CPU 또는 IO를 기다리는 경우, 이 수치는 CPU 코어 수보다 클 수 있습니다.

​

LoadAverage15

전체 시스템 부하를 15분 동안 지수 평활(exponential smoothing)하여 평균낸 값입니다. 이 부하는 현재 CPU에서 실행 중이거나 IO를 기다리고 있거나, 실행할 준비가 되었지만 현재 시점에는 스케줄링되지 않은 모든 프로세스의 스레드 수(OS 커널의 스케줄링 엔터티)를 나타냅니다. 이 수치에는 clickhouse-server만이 아니라 모든 프로세스가 포함됩니다. 시스템에 과부하가 걸려 실행 준비 상태인 프로세스가 많지만 CPU 또는 IO를 기다리는 경우, 이 수치는 CPU 코어 수보다 클 수 있습니다.

​

LoadAverage5

전체 시스템 부하를 5분 동안 지수 평활(exponential smoothing)하여 평균낸 값입니다. 이 부하는 현재 CPU에서 실행 중이거나 IO를 기다리고 있거나, 실행할 준비가 되었지만 현재 시점에는 스케줄링되지 않은 모든 프로세스의 스레드 수(OS 커널의 스케줄링 엔터티)를 나타냅니다. 이 수치에는 clickhouse-server만이 아니라 모든 프로세스가 포함됩니다. 시스템에 과부하가 걸려 실행 준비 상태인 프로세스가 많지만 CPU 또는 IO를 기다리는 경우, 이 수치는 CPU 코어 수보다 클 수 있습니다.

​

LongestRunningMerge

현재 실행 중인 백그라운드 머지 중 가장 오래 실행된 작업의 경과 시간(초)입니다.

​

MaxPartCountForPartition

MergeTree 엔진 계열의 모든 테이블에 있는 모든 파티션을 통틀어, 파티션당 최대 파트 수를 나타냅니다. 값이 300을 초과하면 구성 오류, 과부하 또는 대규모 데이터 로딩을 의미합니다.

​

MemoryCode

서버 프로세스의 머신 코드 페이지에 매핑된 가상 메모리 크기이며, 바이트 단위입니다.

​

MemoryDataAndStack

스택 사용과 할당된 메모리 사용을 위해 매핑된 가상 메모리의 크기를 바이트 단위로 나타냅니다. 여기에 스레드별 스택과 mmap 시스템 호출로 할당된 대부분의 메모리가 포함되는지는 명확하지 않습니다. 이 메트릭은 완전성을 위해서만 존재합니다. 모니터링에는 MemoryResident 메트릭을 사용하는 것을 권장합니다.

​

MemoryResident

서버 프로세스가 사용하는 물리 메모리의 양(바이트)입니다.

​

MemoryResidentMax

서버 프로세스가 사용하는 물리 메모리의 최대 크기(바이트)입니다.

​

MemoryResidentWithoutPageCache

사용자 공간 페이지 캐시를 제외한 서버 프로세스의 물리 메모리 사용량을 바이트 단위로 나타낸 값입니다. 사용자 공간 페이지 캐시를 사용할 때 실제 메모리 사용량을 더 정확하게 파악할 수 있습니다. 사용자 공간 페이지 캐시가 비활성화되면 이 값은 MemoryResident와 동일합니다.

​

MemoryShared

서버 프로세스가 사용하는 메모리 중 다른 프로세스와도 공유되는 부분의 크기를 바이트 단위로 나타냅니다. ClickHouse는 공유 메모리를 사용하지 않지만, 일부 메모리는 운영 체제가 자체적인 이유로 공유 메모리로 분류할 수 있습니다. 이 메트릭은 관찰할 실질적인 의미가 크지 않으며, 완전성을 위해서만 제공됩니다.

​

MemoryVirtual

서버 프로세스에 할당된 가상 주소 공간의 크기(바이트)입니다. 가상 주소 공간의 크기는 일반적으로 실제 메모리 사용량보다 훨씬 크므로, 메모리 사용량을 추정하는 기준으로 사용해서는 안 됩니다. 이 메트릭의 값이 크게 나타나는 것은 지극히 정상이며, 기술적인 의미만 있습니다.

​

MySQLRejectedConnections

MySQL 호환 프로토콜에서 거부된 연결 수입니다.

​

MySQLThreads

MySQL 호환 프로토콜 서버의 스레드 수입니다.

​

NetworkReceiveBytes_interface_name

네트워크 인터페이스를 통해 수신된 바이트 수입니다. 이 메트릭은 시스템 전체 메트릭이며, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다.

​

NetworkReceiveDrop_interface_name

네트워크 인터페이스를 통해 패킷을 수신하는 동안 드롭된 바이트 수입니다. 이는 시스템 전체 메트릭이며, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다.

​

NetworkReceiveErrors_interface_name

네트워크 인터페이스를 통해 수신할 때 오류가 발생한 횟수입니다. 이 메트릭은 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다.

​

NetworkReceivePackets_interface_name

네트워크 인터페이스를 통해 수신된 네트워크 패킷 수입니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐 아니라 호스트 머신의 모든 프로세스를 포함합니다.

​

NetworkSendBytes_interface_name

네트워크 인터페이스를 통해 전송된 바이트 수입니다. 이 메트릭은 시스템 전체 메트릭으로, clickhouse-server만이 아니라 호스트 머신의 모든 프로세스를 포함합니다.

​

NetworkSendDrop_interface_name

네트워크 인터페이스를 통해 전송하는 중 패킷이 손실된 횟수입니다. 이는 시스템 전체 메트릭이며, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다.

​

NetworkSendErrors_interface_name

네트워크 인터페이스를 통해 전송하는 동안 오류(예: TCP 재전송)가 발생한 횟수입니다. 이는 시스템 전체 메트릭으로, clickhouse-server만이 아니라 호스트 머신에서 실행 중인 모든 프로세스를 포함합니다.

​

NetworkSendPackets_interface_name

네트워크 인터페이스를 통해 전송된 네트워크 패킷 수입니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 머신에서 실행되는 모든 프로세스를 포함합니다.

​

NetworkTCPReceiveQueue

서버에서 사용하는 네트워크 소켓의 수신 큐 총 크기이며, TCPv4 및 TCPv6 전체를 포함합니다.

​

NetworkTCPSocketRemoteAddresses

서버에서 사용되는 네트워크 소켓의 고유한 원격 주소 수의 총합입니다(TCPv4 및 TCPv6 전체 기준).

​

NetworkTCPSockets

서버에서 사용 중인 네트워크 소켓의 총개수로, TCPv4 및 TCPv6의 모든 상태를 포함합니다.

​

NetworkTCPSockets_설명

서버에서 TCPv4 및 TCPv6 전반에 걸쳐 특정 상태에 있는 네트워크 소켓의 총수입니다.

​

NetworkTCPTransmitQueue

서버에서 사용하는 TCPv4 및 TCPv6 네트워크 소켓의 전송 큐 총 크기입니다.

​

NetworkTCPUnrecoveredRetransmits

서버에서 사용되는 네트워크 소켓의 현재 재전송량(현재 시점 기준으로 아직 복구되지 않은 재전송)의 총합입니다. TCPv4와 TCPv6를 모두 포함합니다.

​

NumberOfDatabases

서버의 전체 데이터베이스 수입니다.

​

NumberOfDetachedByUserParts

ALTER TABLE DETACH 쿼리를 사용해 사용자가 MergeTree 테이블에서 분리한 파트의 총개수입니다(예기치 않게 발생했거나 손상되었거나 무시된 파트는 제외). 서버는 분리된 파트를 관리하지 않으며 이러한 파트는 제거할 수 있습니다.

​

NumberOfDetachedParts

MergeTree 테이블(table)에서 분리된 파트의 총개수입니다. 파트는 사용자가 ALTER TABLE DETACH 쿼리로 분리할 수도 있고, 파트가 손상되었거나 예기치 않거나 더 이상 필요하지 않은 경우 서버가 자체적으로 분리할 수도 있습니다. 서버는 분리된 파트를 관리하지 않으므로, 해당 파트는 제거할 수 있습니다.

​

NumberOfPendingMutations

아직 처리되지 않은 뮤테이션의 총개수입니다.

​

지정된 실행 시간을 초과한 대기 중 뮤테이션 수

max_pending_mutations_execution_time_to_warn 설정값을 초과했고 아직 뮤테이션이 적용되지 않은 데이터 파트가 남아 있는 뮤테이션의 총수입니다.

​

NumberOfTables

서버의 데이터베이스 전반에서 집계한 테이블의 총개수이며, MergeTree 테이블을 포함할 수 없는 데이터베이스는 제외됩니다. 제외되는 데이터베이스 엔진은 Lazy, MySQL, PostgreSQL, SQlite처럼 테이블 집합을 동적으로 생성하는 엔진입니다.

​

NumberOfTablesSystem

서버의 system 데이터베이스에 있는 테이블 중 MergeTree 엔진 계열에 저장된 테이블의 총 개수입니다.

​

OSContextSwitches

호스트 머신에서 시스템 전체에 발생한 컨텍스트 스위치 횟수입니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐 아니라 호스트 머신의 모든 프로세스를 포함합니다.

​

OSCPUOverload

상대적인 CPU 부족분으로, 다음과 같이 계산됩니다. CPU를 사용 중인 스레드 수에 비해 CPU를 기다리는 스레드가 얼마나 많은지를 나타냅니다. 이 값이 0보다 크면 server는 CPU를 더 추가했을 때 이점을 얻을 수 있습니다. 이 값이 0보다 훨씬 크면 server가 응답하지 않게 될 수 있습니다. 이 메트릭은 비동기 메트릭이 업데이트되는 사이에 누적됩니다.

​

OSGuestNiceTimecpu_suffix

게스트가 더 높은 우선순위로 설정된 상태에서(man procfs 참조) Linux 커널의 제어하에 게스트 운영 체제를 위한 가상 CPU를 실행하는 데 소요된 시간의 비율입니다. 이 메트릭은 시스템 전체 메트릭이므로 clickhouse-server만이 아니라 호스트 머신의 모든 프로세스를 포함합니다. 이 메트릭은 ClickHouse에는 의미가 없지만, 완전성을 위해 제공됩니다. 단일 CPU 코어의 값은 [0..1] 구간입니다. 모든 CPU 코어의 값은 각 코어 값을 합산해 계산하며 범위는 [0..num cores]입니다.

​

OSGuestNiceTimeNormalized

이 값은 OSGuestNiceTime와 비슷하지만, 코어 수와 관계없이 [0..1] 범위에서 측정되도록 CPU 코어 수로 나눈 값입니다. 따라서 클러스터 내 여러 서버의 코어 수가 서로 다르더라도 이 메트릭 값을 평균내어 평균 리소스 사용률 메트릭을 구할 수 있습니다. 지정한 경우 실제 CPU 코어 수 대신 Cgroup CPU quota를 해당 주기로 나눈 값을 사용할 수 있으며, 이 경우에는 특정 시점에 이 메트릭 값이 1을 초과할 수 있습니다.

​

OSGuestTimecpu_suffix

Linux 커널의 제어하에 게스트 운영 체제를 위한 가상 CPU를 실행하는 데 사용된 시간의 비율입니다(man procfs 참조). 이 메트릭은 시스템 전체 메트릭이므로 clickhouse-server만이 아니라 호스트 머신의 모든 프로세스를 포함합니다. 이 메트릭은 ClickHouse에는 의미가 없지만, 완전성을 위해 제공됩니다. 단일 CPU 코어의 값은 [0..1] 범위입니다. 전체 CPU 코어의 값은 모든 코어의 값을 합산하여 계산하며 [0..num cores] 범위입니다.

​

OSGuestTimeNormalized

이 값은 OSGuestTime과 유사하지만, 코어 수와 관계없이 [0..1] 인터벌로 측정할 수 있도록 CPU 코어 수로 나눈 값입니다. 따라서 클러스터 내 여러 서버의 코어 수가 서로 다르더라도 이 메트릭 값을 평균하여 평균 리소스 사용률 메트릭을 얻을 수 있습니다. 설정한 경우 실제 CPU 코어 수 대신 Cgroup CPU quota를 해당 period로 나눈 값을 사용할 수 있으며, 이 경우에는 일부 시점에서 이 메트릭 값이 1을 초과할 수 있습니다.

​

OSIdleTimecpu_suffix

OS 커널 관점에서 CPU 코어가 유휴 상태였던 시간의 비율입니다(즉, IO를 기다리는 프로세스를 실행할 준비 상태조차 아닌 경우). 이는 시스템 전체 메트릭으로, clickhouse-server뿐 아니라 호스트 머신의 모든 프로세스를 포함합니다. CPU 내부 원인(메모리 로드, 파이프라인 정체, 브랜치 예측 실패, 다른 SMT 코어 실행)으로 인해 CPU가 충분히 활용되지 않은 시간은 여기에 포함되지 않습니다. 단일 CPU 코어의 값은 [0..1] 인터벌에 있습니다. 모든 CPU 코어의 값은 각 코어 값을 합산한 [0..num cores]로 계산됩니다.

​

OSIdleTimeNormalized

이 값은 OSIdleTime과 유사하지만, 코어 수와 관계없이 [0..1] 인터벌에서 측정할 수 있도록 CPU 코어 수로 나눈 값입니다. 따라서 클러스터 내 여러 서버의 코어 수가 서로 다르더라도 이 메트릭의 값을 평균낼 수 있으며, 그 경우에도 평균 리소스 사용률 메트릭을 얻을 수 있습니다. 지정한 경우 실제 CPU 코어 수 대신 Cgroup CPU quota를 해당 period로 나눈 값을 사용할 수 있으며, 이때는 일부 시점에 이 메트릭 값이 1을 초과할 수 있습니다.

​

OSInterrupts

호스트 머신에서 발생한 인터럽트 수입니다. 이 값은 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 머신에서 실행되는 모든 프로세스를 포함합니다.

​

OSIOWaitTimecpu_suffix

프로세스가 IO를 기다리는 동안 CPU 코어가 코드를 실행하지 않았고, OS 커널도 해당 CPU에서 다른 프로세스를 실행하지 않은 시간의 비율입니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다. 단일 CPU 코어의 값은 [0..1] 인터벌에 속합니다. 전체 CPU 코어의 값은 각 코어의 값을 합산하여 [0..num cores] 범위로 계산됩니다.

​

OSIOWaitTimeNormalized

이 값은 OSIOWaitTime과 비슷하지만, 코어 수와 관계없이 [0..1] 인터벌에서 측정될 수 있도록 CPU 코어 수로 나눈 값입니다. 이를 통해 클러스터 내 여러 서버의 코어 수가 서로 다르더라도 이 메트릭 값을 평균하여 평균 리소스 사용률 메트릭을 구할 수 있습니다. 지정된 경우 실제 CPU 코어 수 대신 주기로 나눈 Cgroup CPU quota를 사용할 수 있으며, 이때는 특정 시점에 이 메트릭 값이 1을 초과할 수도 있습니다.

​

OSIrqTimecpu_suffix

CPU에서 하드웨어 인터럽트 요청을 처리하는 데 사용된 시간의 비율입니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐 아니라 호스트 머신의 모든 프로세스를 포함합니다. 이 메트릭 값이 높으면 하드웨어 구성 문제 또는 매우 높은 네트워크 부하를 의미할 수 있습니다. 단일 CPU 코어의 값은 [0..1] 인터벌입니다. 모든 CPU 코어의 값은 각 코어 값을 합산하여 계산하며 범위는 [0..num cores]입니다.

​

OSIrqTimeNormalized

이 값은 OSIrqTime과 유사하지만, 코어 수와 관계없이 [0..1] 인터벌에서 측정할 수 있도록 CPU 코어 수로 나눈 값입니다. 이를 통해 클러스터 내 여러 서버의 코어 수가 서로 다르더라도 이 메트릭 값을 평균하여 평균 리소스 사용률 메트릭을 얻을 수 있습니다. 지정한 경우 실제 CPU 코어 수 대신 Cgroup CPU quota를 해당 period로 나눈 값을 사용할 수 있으며, 이때는 일부 시점에서 이 메트릭 값이 1을 초과할 수 있습니다.

​

OSMemoryAvailable

프로그램에서 사용할 수 있는 메모리의 양을 바이트 단위로 나타냅니다. 이는 OSMemoryFreePlusCached 메트릭과 매우 유사합니다. 이 메트릭은 시스템 전체 메트릭으로, clickhouse-server만이 아니라 호스트 머신의 모든 프로세스를 포함합니다.

​

OSMemoryBuffers

OS 커널 버퍼가 사용하는 메모리 양으로, 단위는 바이트입니다. 일반적으로 이 값은 작아야 하며, 값이 크면 OS가 잘못 구성되었을 수 있습니다. 이는 시스템 전체 메트릭으로, clickhouse-server만이 아니라 호스트 머신의 모든 프로세스를 포함합니다.

​

OSMemoryCached

OS 페이지 캐시에서 사용하는 메모리의 양을 바이트 단위로 나타냅니다. 일반적으로 사용 가능한 메모리의 거의 대부분은 OS 페이지 캐시에서 사용되므로, 이 메트릭의 값이 높게 나타나는 것은 정상이며 예상된 동작입니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다.

​

OSMemoryFreePlusCached

호스트 시스템의 여유 메모리와 OS 페이지 캐시 메모리의 합계로, 단위는 바이트입니다. 이 메모리는 프로그램에서 사용할 수 있습니다. 이 값은 OSMemoryAvailable와 매우 유사해야 합니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐 아니라 호스트 머신의 모든 프로세스를 포함합니다.

​

OSMemoryFreeWithoutCached

호스트 시스템의 여유 메모리 크기를 바이트 단위로 나타냅니다. 여기에는 운영체제의 페이지 캐시에 사용되는 메모리는 포함되지 않습니다. 하지만 페이지 캐시 메모리도 프로그램에서 사용할 수 있으므로, 이 메트릭 값은 혼동을 일으킬 수 있습니다. 대신 OSMemoryAvailable 메트릭을 확인하십시오. 편의를 위해 OSMemoryFreePlusCached 메트릭도 제공하며, 이는 OSMemoryAvailable과 어느 정도 비슷한 값을 나타냅니다. 자세한 내용은 https://www.linuxatemyram.com/도 참조하십시오. 이는 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다.

​

OSMemorySwapCached

스왑에 있으면서 RAM에도 로드된 메모리의 양입니다. 운영 시스템에서는 스왑을 비활성화해야 합니다. 이 메트릭의 값이 크면 구성이 잘못되었음을 나타냅니다. 이 메트릭은 시스템 전체 메트릭이며, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다.

​

OSMemoryTotal

호스트 시스템의 총 메모리 크기(바이트)입니다.

​

OSNiceTimecpu_suffix

CPU 코어가 더 높은 우선순위로 사용자 공간 코드를 실행한 시간의 비율입니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐 아니라 호스트 머신의 모든 프로세스를 포함합니다. 단일 CPU 코어의 값은 [0..1] 인터벌입니다. 모든 CPU 코어의 값은 각 코어 값의 합으로 계산되며 범위는 [0..num cores]입니다.

​

OSNiceTimeNormalized

이 값은 OSNiceTime과 유사하지만, 코어 수와 관계없이 [0..1] 인터벌에서 측정할 수 있도록 CPU 코어 수로 나눈 값입니다. 이를 통해 cluster 내 여러 server의 코어 수가 서로 달라도 이 메트릭 값을 평균하여 여전히 평균 리소스 사용률 메트릭을 구할 수 있습니다. 지정된 경우 실제 CPU 코어 수 대신 주기로 나눈 Cgroup CPU quota를 사용할 수 있으며, 이때는 일부 시점에서 이 메트릭 값이 1을 초과할 수 있습니다.

​

OSOpenFiles

호스트 머신에서 열려 있는 파일의 총 개수입니다. 이는 시스템 전체 메트릭으로, clickhouse-server만이 아니라 호스트 머신의 모든 프로세스를 포함합니다.

​

OSProcessesBlocked

I/O 완료를 기다리며 블록된 스레드 수입니다(man procfs). 이는 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 시스템의 모든 프로세스를 포함합니다.

​

OSProcessesCreated

생성된 프로세스 수입니다. 이 메트릭은 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 시스템의 모든 프로세스를 포함합니다.

​

OSProcessesRunning

운영 체제에서 실행 가능 상태(실행 중이거나 실행 준비가 된 상태)인 스레드 수입니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다.

​

OSSoftIrqTimecpu_suffix

CPU에서 소프트웨어 인터럽트 요청을 처리하는 데 소요된 시간의 비율입니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 시스템의 모든 프로세스를 포함합니다. 이 메트릭 값이 높으면 시스템에서 비효율적인 소프트웨어가 실행되고 있음을 의미할 수 있습니다. 단일 CPU 코어의 값은 인터벌 [0..1]입니다. 모든 CPU 코어의 값은 각 코어의 값을 합산하여 계산하며 범위는 [0..num cores]입니다.

​

OSSoftIrqTimeNormalized

이 값은 OSSoftIrqTime과 유사하지만, 코어 수와 관계없이 [0..1] 인터벌에서 측정할 수 있도록 CPU 코어 수로 나눈 값입니다. 따라서 코어 수가 균일하지 않은 경우에도 클러스터 내 여러 서버에서 이 메트릭 값을 평균하여 평균 리소스 사용률 메트릭을 얻을 수 있습니다. 지정한 경우 실제 CPU 코어 수 대신 Cgroup CPU quota를 해당 period로 나눈 값을 사용할 수 있으며, 이 경우에는 이 메트릭 값이 일부 시점에서 1을 초과할 수 있습니다.

​

OSStealTimecpu_suffix

가상화 환경에서 실행될 때 CPU가 다른 운영 체제의 작업을 처리하는 데 사용한 시간의 비율입니다. 이는 시스템 전체 메트릭으로, clickhouse-server만이 아니라 호스트 머신의 모든 프로세스를 포함합니다. 이 메트릭은 모든 가상화 환경에서 제공되지는 않으며, 대부분의 환경에서는 제공되지 않습니다. 단일 CPU 코어의 값은 [0..1] 인터벌입니다. 전체 CPU 코어의 값은 모든 코어 값을 합산하여 계산하며, 범위는 [0..num cores]입니다.

​

OSStealTimeNormalized

이 값은 OSStealTime과 비슷하지만, 코어 수와 관계없이 [0..1] 인터벌에서 측정할 수 있도록 CPU 코어 수로 나눈 값입니다. 따라서 클러스터 내 여러 서버의 코어 수가 서로 다르더라도 이 메트릭 값을 평균해 평균 리소스 사용률 메트릭을 얻을 수 있습니다. 지정된 경우 실제 CPU 코어 수 대신 주기로 나눈 Cgroup CPU quota를 사용할 수 있으며, 이 경우에는 특정 시점에 이 메트릭 값이 1을 초과할 수 있습니다.

​

OSSystemTimecpu_suffix

CPU 코어가 운영체제 커널(system) 코드를 실행한 시간의 비율입니다. 이는 시스템 전체 메트릭으로, clickhouse-server뿐만 아니라 호스트 머신의 모든 프로세스를 포함합니다. 단일 CPU 코어의 값은 [0..1] 인터벌에 있습니다. 전체 CPU 코어의 값은 모든 코어의 합으로 계산되며 [0..num cores] 범위에 있습니다.

​

OSSystemTimeNormalized

이 값은 OSSystemTime와 유사하지만, 코어 수와 관계없이 [0..1] 인터벌에서 측정되도록 CPU 코어 수로 나눈 값입니다. 따라서 클러스터 내 여러 서버의 코어 수가 서로 다르더라도 이 메트릭 값의 평균을 낼 수 있으며, 그 경우에도 평균 리소스 사용률 메트릭을 얻을 수 있습니다. 지정된 경우 실제 CPU 코어 수 대신 Cgroup CPU quota를 해당 주기로 나눈 값을 사용할 수 있으며, 이 경우에는 특정 시점에 이 메트릭 값이 1을 초과할 수 있습니다.

​

OSThreadsRunnable

OS 커널 스케줄러가 인식하는 ‘실행 가능’ thread의 총수입니다.

​

OSThreadsTotal

OS 커널 스케줄러가 인식하는 전체 스레드 수입니다.

​

OSUptime

호스트 server(ClickHouse가 실행 중인 머신)의 업타임을 초 단위로 나타냅니다.

​

OSUserTimecpu_suffix

CPU 코어가 사용자 공간 코드를 실행한 시간의 비율입니다. 이는 시스템 전체 메트릭이므로 clickhouse-server뿐 아니라 호스트 시스템의 모든 프로세스를 포함합니다. 또한 메모리 로드, 파이프라인 스톨, 브랜치 예측 실패, 다른 SMT 코어 실행 등 CPU 내부 요인으로 인해 CPU 활용도가 낮았던 시간도 포함됩니다. 단일 CPU 코어의 값은 [0..1] 인터벌입니다. 모든 CPU 코어의 값은 각 코어 값을 합산하여 계산하며 [0..num cores] 인터벌입니다.

​

OSUserTimeNormalized

이 값은 OSUserTime과 유사하지만, CPU 코어 수와 관계없이 [0..1] 인터벌로 측정할 수 있도록 CPU 코어 수로 나눈 값입니다. 따라서 클러스터 내 여러 서버의 코어 수가 서로 달라도 이 메트릭 값을 평균할 수 있으며, 그 결과 평균 리소스 사용률 메트릭을 얻을 수 있습니다. 지정한 경우에는 실제 CPU 코어 수 대신 Cgroup CPU quota를 해당 period로 나눈 값을 사용할 수 있으며, 이 경우에는 특정 시점에 이 메트릭 값이 1을 초과할 수 있습니다.

​

PageCacheMaxBytes

사용자 공간 페이지 캐시의 현재 크기 한도이며, 단위는 바이트입니다.

​

PostgreSQLRejectedConnections

PostgreSQL 호환 프로토콜에 대한 거부된 연결 수입니다.

​

PostgreSQLThreads

PostgreSQL 호환 프로토콜 서버의 스레드 수입니다.

​

ProcessSignalQueueLimit

시그널 큐의 전체 한도입니다(이 값이 ProcessSignalQueueSize에 도달하면 CANNOT_CREATE_TIMER 오류가 발생할 수 있습니다)

​

ProcessSignalQueueSize

시그널 큐의 크기(대기 중인 시그널, 쿼리 프로파일링용 타이머)

​

PrometheusRejectedConnections

Prometheus 엔드포인트에서 거부된 연결 수입니다. 참고: Prometheus 엔드포인트는 일반적인 HTTP/HTTPS 포트를 통해서도 사용할 수 있습니다.

​

PrometheusThreads

Prometheus 엔드포인트 서버의 스레드 수입니다. 참고: Prometheus 엔드포인트는 일반적인 HTTP/HTTPS 포트를 통해서도 사용할 수 있습니다.

​

PSI_type_stall_type

마지막 측정 이후의 stall 시간을 마이크로초 단위로 나타냅니다. 메트릭과 해석 방법은 업스트림 문서 https://docs.kernel.org/accounting/psi.html 에서 확인할 수 있습니다.

​

QueriesMemoryUsage

현재 server에서 실행 중인 모든 쿼리가 사용 중인 총 메모리 양으로, 바이트 단위입니다. 메모리 압박이 동시 실행되는 쿼리 부하로 인한 것인지 파악하는 데 유용합니다.

​

쿼리 최대 메모리 사용량

ProcessList에서 추적되는 모든 사용자의 사용자별 쿼리 메모리 피크값 합계이며, 단위는 바이트입니다. 각 사용자의 피크값은 해당 사용자의 memory tracker에 기록된 최고 수위이며, 실행 중인 쿼리가 없으면 초기화됩니다. 따라서 이는 현재 추적 중인 사용자별 피크값을 집계한 것이며, 서버 시작 이후 모든 쿼리를 통틀어 계산한 서버 전체의 단일 피크값은 아닙니다.

​

ReplicasMaxAbsoluteDelay

복제된 테이블(Replicated Table) 전반에서, 가장 최신의 복제된 파트와 아직 복제되지 않은 가장 최신 데이터 파트 사이의 최대 시간 차이(초)입니다. 값이 매우 크면 데이터가 없는 레플리카를 의미합니다.

​

ReplicasMaxInsertsInQueue

복제된 테이블 전체에서 큐에 있는(아직 복제되지 않은) INSERT 작업의 최대 개수입니다.

​

ReplicasMaxMergesInQueue

복제된 테이블(Replicated Table) 전체에서 큐에 대기 중인(아직 적용되지 않은) 머지 작업의 최대 개수입니다.

​

ReplicasMaxQueueSize

복제된 테이블 전반의 최대 큐 크기입니다(get, merge 등의 작업 수 기준).

​

ReplicasMaxRelativeDelay

복제된 테이블 전체에서, 레플리카 지연과 동일한 테이블에서 가장 최신 상태인 레플리카의 지연 사이의 최대 차이입니다.

​

ReplicasSumInsertsInQueue

복제된 테이블 전체에서 큐에 있는 INSERT 작업(아직 복제 대기 중)의 합계입니다.

​

ReplicasSumMergesInQueue

복제된 테이블 전체에서 큐에 있는(아직 적용되지 않은) 머지 작업 수의 합계입니다.

​

ReplicasSumQueueSize

복제된 테이블 전체에서 get, merge와 같은 작업 수를 기준으로 한 큐 크기의 합입니다.

​

TCPRejectedConnections

TCP 프로토콜(TLS 미사용)에서 거부된 연결 수입니다.

​

TCPSecureRejectedConnections

TLS를 사용하는 TCP 프로토콜에서 거부된 연결 수입니다.

​

TCPSecureThreads

TLS를 사용하는 TCP 프로토콜 서버에서 실행 중인 스레드 수입니다.

​

TCPThreads

TLS를 사용하지 않는 TCP 프로토콜 서버의 스레드 수입니다.

​

샘플링 온도i

해당 장치의 온도(℃)입니다. 센서가 비정상적인 값을 반환할 수 있습니다. 출처: /sys/class/thermal

​

샘플링 온도_hwmon_name

해당 하드웨어 모니터에서 보고된 온도(℃)입니다. 센서는 비정상적인 값을 반환할 수 있습니다. 출처: /sys/class/hwmon

​

샘플링 온도_hwmon_name_sensor_name

해당 하드웨어 모니터와 센서에서 보고된 온도(℃)입니다. 센서는 비정상적인 값을 반환할 수 있습니다. 출처: /sys/class/hwmon

​

TotalBytesOfMergeTreeTables

MergeTree 엔진 계열의 모든 테이블에 저장된 총 바이트 수입니다(압축된 상태이며, 데이터와 인덱스를 포함).

​

TotalBytesOfMergeTreeTablesSystem

system 데이터베이스에 있는 MergeTree 엔진 계열 테이블에 저장된 총 바이트 수입니다(데이터와 인덱스를 포함한 압축 크기).

​

TotalIndexGranularityBytesInMemory

인덱스 그래뉼이 사용하는 총 메모리 양(바이트)입니다(활성 파트만 집계).

​

TotalIndexGranularityBytesInMemoryAllocated

인덱스 그래뉼에 예약된 메모리의 총량(바이트)입니다(활성 파트만 집계에 포함됩니다).

​

MergeTree 엔진 계열 테이블의 총 파트 수

MergeTree 엔진 계열의 모든 테이블에 있는 데이터 파트의 총 개수입니다. 이 값이 10 000을 초과하면 서버 시작 시간에 부정적인 영향을 미칠 수 있으며, 파티션 키를 적절하지 않게 선택했음을 의미할 수 있습니다.

​

system 데이터베이스의 MergeTree 엔진 계열 테이블의 총 파트 수

system 데이터베이스에 있는 MergeTree 엔진 계열 테이블의 데이터 파트 총 개수입니다.

​

TotalPrimaryKeyBytesInMemory

기본 키 값이 사용하는 총 메모리 양(바이트)입니다(활성 파트만 포함).

​

TotalPrimaryKeyBytesInMemoryAllocated

기본 키 값을 위해 메모리에 예약된 총 크기(바이트)입니다(활성 파트만 고려함).

​

TotalProjectionIndexGranularityBytesInMemory

프로젝션 인덱스 세분화 수준에서 사용하는 총 메모리 양(바이트)입니다(활성 파트만 고려함).

​

TotalProjectionIndexGranularityBytesInMemoryAllocated

프로젝션 인덱스 세분화 수준에 예약된 총 메모리 양(바이트)입니다(활성 파트만 고려합니다).

​

TotalProjectionPrimaryKeyBytesInMemory

프로젝션 기본 키 값이 사용하는 전체 메모리 크기(바이트 단위)입니다(활성 파트만 집계합니다).

​

TotalProjectionPrimaryKeyBytesInMemoryAllocated

프로젝션 기본 키 값을 위해 예약된 전체 메모리 양(바이트)입니다(활성 파트만 계산에 포함됩니다).

​

TotalRowsOfMergeTreeTables

모든 MergeTree 엔진 계열 테이블에 저장된 총 행(레코드) 수입니다.

​

TotalRowsOfMergeTreeTablesSystem

system 데이터베이스의 MergeTree 엔진 계열 테이블에 저장된 행(레코드)의 총 수입니다.

​

TotalUncompressedBytesOfMergeTreeTables

MergeTree 엔진 계열의 모든 테이블에 저장된 비압축 바이트 총량으로, 파트 체크섬(part checksums)에 보고된 값을 기준으로 합니다. 이는 system.tables의 total_bytes_uncompressed 컬럼과 같은 값의 출처이며, 마크 및 프라이머리 키 인덱스처럼 비압축 상태로 저장되는 파일은 포함하지 않습니다.

​

TotalUncompressedBytesOfMergeTreeTablesSystem

system 데이터베이스의 MergeTree 엔진 계열 테이블에 저장된 비압축 바이트의 총량입니다. 이 값은 part checksums에 기록된 기준으로 집계됩니다. system.tables의 total_bytes_uncompressed 컬럼과 동일한 소스를 사용하며, 마크와 프라이머리 키 인덱스처럼 비압축 상태로 저장되는 파일은 포함하지 않습니다.

​

TrackedMemory

ClickHouse가 추적하는 메모리로, 바이트 단위이며 MemoryTracking 메트릭과 동일해야 합니다.

​

업타임

서버의 업타임을 초 단위로 나타냅니다. 연결을 수락하기 전에 수행되는 서버 초기화 시간도 포함됩니다.

​

VMMaxMapCount

프로세스가 가질 수 있는 최대 메모리 매핑 수입니다 (/proc/sys/vm/max_map_count).

​

VMNumMaps

프로세스의 현재 메모리 매핑 수입니다(/proc/self/maps). 이 값이 최대값(VMMaxMapCount)에 가까우면 /etc/sysctl.conf에서 vm.max_map_count 제한을 늘리십시오.

​

ZooKeeperClientLastZXIDSeen

현재 ZooKeeper 클라이언트 세션에서 마지막으로 확인된 ZXID입니다. 이 값은 클라이언트가 ZooKeeper의 트랜잭션을 확인할수록 지속적으로 증가합니다.

관련 항목

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