vllm-project / vllm-project/production-stack
feature: enhance observability with instance-level and routing-level metrics
Nobody has claimed this yet.
- 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:
- Reusing vLLM’s observability framework for instance-level metrics (e.g., per-instance latency, throughput), as it offers finer granularity and better usability.
- 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.
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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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