首页/AI/大模型部署与运维速查/KV 水位指标与扩容信号
运维监控与排障50 条

KV 水位指标与扩容信号

vLLM 的 gpu_cache_usage_perc 反映 KV 池占用比例;配合等待请求数看:水位高且排队=容量到顶,水位高不排队=还有调度余量,水位低而排队=瓶颈在别处。

指标速览(名字以本机 /metrics 输出为准)

指标速览(名字以本机 /metrics 输出为准)
vllm:gpu_cache_usage_perc   # KV 池使用率 0~1
vllm:num_requests_waiting   # 等待调度请求数
vllm:num_requests_running   # 正在生成的请求数
  • 水位持续高位且等待数上涨 → 扩容或限制并发
  • 峰值水位留 15%~20% 裕量,红冲说明容量预估偏紧
  • 结合输入长度分布看:长请求占用的 KV 块更多
KV 水位与延迟联动看:高水位本身不是故障,排队时长变长才是要动作的信号。

易错点

  • 把水位当唯一扩容依据:模型或版本变化会改变 KV 块尺寸,历史阈值需要重标定

数据来源与参考

  • vLLM 官方文档:Production Metrics(docs.vllm.ai)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌