system-cache-stats
테이블 캐시, 인덱스 캐시, 블룸 필터 캐시의 hit/miss 통계를 조회합니다. 클러스터 관리자 권한이 필요합니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 드라이버 쿼리 |
| 필요 권한 | 클러스터 관리자 권한 |
| 라이선스 사용량 | 집계 안 함 |
| 병렬 실행 | 미지원 |
| 분산 실행 | 미지원 |
문법
system-cache-stats
system-cache-stats 명령어는 옵션이나 인수를 지정할 수 없습니다. 명령어 이름 뒤에 값을 입력하면 오류가 발생합니다.
입력 필드
없음 (드라이버 쿼리이므로 파이프라인에서 첫 번째 명령어로만 사용합니다)
출력 필드
| 필드 | 타입 | 설명 |
|---|---|---|
| cache | 문자열 | 캐시 저장소 이름. table(테이블 캐시), index(인덱스 캐시), bloomfilter0, bloomfilter1(블룸 필터 레벨 0, 1 캐시) 중 하나 |
| request_count | 64비트 정수 | 총 캐시 조회 수(적중 + 미스) |
| hit_count | 64비트 정수 | 캐시 적중 횟수 |
| miss_count | 64비트 정수 | 캐시 미스 횟수 |
| hit_rate | 64비트 실수 | 캐시 적중률(0.0-1.0) |
| eviction_count | 64비트 정수 | 축출된 캐시 항목 수 |
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 95130 | [command] 명령어는 인수를 받지 않습니다: [args] | 명령어 이름 뒤에 옵션이나 값을 입력한 경우 |
| 95160 | 읽기 권한이 없습니다. 클러스터 관리자 권한이 필요합니다. | 클러스터 관리자 권한이 없는 경우 |
런타임 오류
해당 사항 없음
설명
system-cache-stats 명령어는 테이블 캐시, 인덱스 캐시(inverted 인덱스), 블룸 필터 캐시(레벨 0, 1)의 요청 수, 적중 수, 미스 수, 적중률, 축출 수를 조회합니다. 캐시별로 한 행씩 반환합니다.
통계 기록은 기본적으로 활성화되어 있어 별도 설정 없이 값이 채워집니다. 캐시 크기는 logpresso.conf의 CACHE_SIZE, INVERTED_CACHE_SIZE 등의 옵션으로 조정할 수 있습니다.
특정 캐시의 통계 기록을 비활성화하면 해당 캐시의 통계 자체가 비어 있게 되어, 그 캐시에 대응하는 행이 조회 결과에서 아예 빠집니다(오류는 발생하지 않습니다). 조회 결과에 일부 캐시(table, index, bloomfilter0, bloomfilter1)가 보이지 않는다면 해당 캐시의 통계 기록 설정을 먼저 확인하세요.
사용 예
-
전체 캐시 통계 조회
system-cache-stats -
적중률이 낮은 캐시만 조회
system-cache-stats | search hit_rate < 0.5 -
캐시별 축출 수 기준 정렬
system-cache-stats | sort -eviction_count
변경 이력
system-cache-stats 명령어는 소나 4.0.2609.0 버전부터 사용 가능합니다.