카운트

원문 보기 위키 갱신 2026.10.05

카운트 (Count)

카운트 함수는 메트릭 값이 0이 아닌 태그 값 개수, 또는 null이 아닌 태그 값 개수를 세어 주는 함수예요. 여러 호스트나 인스턴스가 묶인 쿼리에서 실제로 값을 내보내는 대상이 몇 개인지 파악할 때 유용합니다.

출처: 문서

함수	설명	예시
`count_nonzero()`	모든 0이 아닌 값의 개수를 계산합니다.	`count_nonzero(<METRIC_NAME>{*})`

하나 이상의 태그 키(tag keys)로 그룹화된 쿼리에서, 각 시점마다 메트릭 값이 0이 아닌 태그 값의 개수를 세어 주는 함수예요.

예시: count_nonzero(system.cpu.user{*} by {host})는 각 시점마다 시스템 로드가 0이 아닌 호스트 수를 나타내는 시계열을 반환합니다.

참고: count_nonzero_finite()를 count_nonzero()의 별칭으로 사용할 수 있어요.

함수	설명	예시
`count_not_null()`	모든 null이 아닌 값의 개수를 계산합니다.	`count_not_null(<METRIC_NAME>{*})`

하나 이상의 태그 키(tag keys)로 그룹화된 쿼리에서, 각 시점마다 메트릭 값이 null이 아닌 태그 값의 개수를 세어 주는 함수예요. 메트릭 값이 null이라는 것은 유한(finite)한 값이 없다는 뜻이에요.

예시: count_not_null(system.cpu.user{*} by {host})는 각 시점마다 시스템 로드가 null이 아닌 호스트 수를 나타내는 시계열을 반환합니다.

사용할 수 있는 다른 함수들을 확인해 보세요: