[RHEL] pmseries PCP 시계열을 쿼리하는 명령

부제: pmproxy가 키 서버(valkey/redis)에 적재한 시계열을 SQL 대신 pmseries 문법으로 질의한다

pmseries 'disk.dev.read'           # 메트릭 이름으로 시계열 검색
pmseries -a 'SERIES_ID'            # 시계열 ID의 모든 메타데이터
pmseries --help                    # 옵션 요약

Usage: pmseries [options] [query ... | labels ... | series ... | source ...]

General Options:
  -L, --load            load time series values and metadata
  -q, --query           perform a time series query (default)
  -v, --values          extract values for given series or label(s)

Reporting Options:
  -a, --all             report all metadata (-dilms) for time series
  -i, --instances       report names for time series instances
  -l, --labels          list all labels for time series
  -m, --metrics         report names and expressions for time series

pmseries는 PCP의 확장 기능인 시계열 질의 도구다. 라이브 pmcd를 직접 보는 게 아니라, pmproxy가 valkey/redis 같은 키 서버에 적재해 둔 시계열을 상대로 이름·라벨·값 질의를 던진다. 여러 호스트의 아카이브를 한곳에 모아 라벨(호스트·인스턴스)로 가로질러 검색할 수 있어, 대규모 모니터링의 백엔드 조회 계층으로 쓴다. 키 서버와 pmproxy가 떠 있지 않으면 아래처럼 연결 거부가 난다.

pmseries(10189) Info: Cannot connect to key server: Connection refused

즉 이 명령을 실제로 쓰려면 valkey 설치 후 pmproxy 서비스(systemctl enable --now pmproxy)를 먼저 올리고, pmlogger 아카이브를 pmseries -L로 적재해 둬야 한다. (검증 VM은 키 서버 미기동 상태라 질의 결과 대신 연결 거부만 확인했다.)

이렇게도 쓴다

시계열 백엔드를 먼저 띄운다. (systemctl 조합)

dnf install -y valkey && systemctl enable --now valkey pmproxy

 

아카이브를 시계열 저장소에 적재한다. (-L 조합)

pmseries -L /var/log/pcp/pmlogger/$(hostname)/*.0

 

메트릭 이름에 매칭되는 시계열의 라벨을 본다. (-l 조합)

pmseries -l 'kernel.all.load'

 

라벨로 여러 호스트를 가로질러 질의한다.

pmseries 'disk.dev.read{hostname=="rocky-9-cmd"}'

 

시계열 ID 하나의 모든 메타데이터를 펼친다. (-a 조합)

pmseries -a $(pmseries 'mem.util.free' | head -1)