1. Modifier(변경자)

PromQL에서 메트릭을 선택하거나 매칭할 때 사용됨.

by() — 그룹 기준 지정

sum(rate(container_cpu_usage_seconds_total[5m])) by (pod)

without() — 제외하고 그룹핑

sum without(instance)(node_cpu_seconds_total)

offset — 이전 시간 데이터 사용

node_disk_read_bytes_total - node_disk_read_bytes_total offset 5m

2. Functions(함수)

PromQL은 함수를 많이 제공한다.

자주 쓰는 함수:

함수	설명
rate()	카운터의 증가율 계산
irate()	가장 최근 샘플 기준 증가율
sum()/avg()	흔히 쓰는 집계 함수
increase()	일정 구간 동안 얼마나 증가했는지
topk()	상위 n개 선택

ex)

topk(3, rate(http_requests_total[5m]))

3. PromQL 조합 예시 — 실무에서 가장 잘 쓰는 형태

① 파드 CPU 사용률 (5분 평균)

sum(rate(container_cpu_usage_seconds_total[5m])) by (pod)

② 노드별 메모리 사용률

(node_memory_MemTotal_bytes - node_memory_MemAvailable_bytes) 
  / node_memory_MemTotal_bytes

③ HTTP 요청 수 증가율

rate(http_requests_total[5m])

④ 파드 재시작 수가 0보다 큰 파드만 보기

kube_pod_container_status_restarts_total > 0