Schema.ai· vLLM
vLLM official site ↗vLLM v0.23.0API up

In vLLM v0.23.0, vllm:kv_cache_usage_perc is set from SchedulerStats.kv_cache_usage and observes KV-cache usage pressure.

MetricvLLM v0.23.0confidence: highverified 12 min agoverified-code

Metric

kv_cache_usage_perc

Applies when

V1 scheduler statsPrometheusStatLogger metrics publisher

Evidence

vLLM v0.23.0 v1 metrics stats.py(vllm/v1/metrics/stats.py:171-188)
definesprimarysource_codecode_introspection
vLLM v0.23.0 v1 metrics loggers.py(vllm/v1/metrics/loggers.py:1081-1081)
definesprimarysource_codecode_introspection

Does not establish

  • actual preemption occurrence by itself
  • the correct tuning action for a workload
  • quantitative benchmark outcomes

Guards

  • vllm_version = v0.23.0
  • metric_name = vllm:kv_cache_usage_perc
  • runtime_component = scheduler

Freshness

Pinned release-tag source snapshot; re-check if target phase-1 release changes or metrics API compatibility becomes customer-facing.