vllm-project / vllm-project/production-stack

feature: enhance observability with instance-level and routing-level metrics

Open
#474 6 comments 5 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

feature request
Dominant language
Python
Stars
2.6k
Forks
503
Avg merge
4d 17h
Merged PRs (30d)
8

Description

Describe the feature

Currently, the observability in production-stack is limited, primarily offering coarse-grained cluster-level metrics. Compared to the existing metrics by vLLM's observability system, they lack instance-level metrics and don’t provide sufficient insights for routing decisions—especially as we scale to support more complex or user-defined routing algorithms (e.g., like those in AIBrix).

I propose:

  1. Reusing vLLM’s observability framework for instance-level metrics (e.g., per-instance latency, throughput), as it offers finer granularity and better usability.
  2. Adding routing-specific metrics, such as: per-instance QPS (critical for current routing), routing decision metadata (e.g., algorithm used, fallback triggers, retries) for future complex routing logic.
Why do you need this feature?
  • Instance-level: vLLM’s existing metrics are more detailed making them a better fit in production scenarios.
  • Routing-level: As routing grows more complex (e.g., dynamic load balancing, kvcache-aware routing), observability will be key to debugging and optimization. Without it, diagnosing issues like skewed load or suboptimal routing becomes opaque.
Additional context

This is a demo based on vLLM's observability framework, implementing a session-based router with integrated real-time QPS monitoring for each vLLM instance at the routing-level.
Image
Are there any other essential metrics I might have overlooked for effective monitoring? Please don't hesitate to provide input!
@YuhanLiu11 @ApostaC @Shaoting-Feng

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing vLLM’s observability framework and production-stack’s existing cluster-level metrics. Compare the session-based router demo and its real-time per-instance QPS monitoring with the requested instance-level and routing-level metrics, then clarify the metric scope and validation approach with maintainers.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
distributed-systems, observability
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.