Skip to main content

A monitoring tool for vLLM metrics.

Project description

vllm-top

PyPI version

Demo

vllm-top is a Python package for monitoring and displaying metrics from the vLLM service. It provides a comprehensive dashboard to visualize both current state and historical performance, making it easy to track and analyze service behavior over time.


🚀 Features

  • Task State Visibility: Instantly see GPU Cache Usage, Running and Waiting requests to help debug bottlenecks and improve throughput.
  • Minimalist Monitoring: Lightweight dashboard that parses metrics directly from Prometheus.
  • Quick Setup: No extra configuration — just pip install and run.

📦 Installation

Install via pip:

pip install vllm-top

🛠️ Usage

Start monitoring:

vllm-top

Change update interval (in seconds):

vllm-top --interval 5

Get a one-time snapshot:

vllm-top --snapshot

🤝 Contributing

Contributions are welcome! Please submit a pull request or open an issue for enhancements or bug fixes.


📄 License

Licensed under the MIT License. See the LICENSE file for details.


📜 Changelog

See CHANGELOG.md for a detailed

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vllm_top-0.1.2.tar.gz (9.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vllm_top-0.1.2-py3-none-any.whl (8.2 kB view details)

Uploaded Python 3

File details

Details for the file vllm_top-0.1.2.tar.gz.

File metadata

  • Download URL: vllm_top-0.1.2.tar.gz
  • Upload date:
  • Size: 9.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.0

File hashes

Hashes for vllm_top-0.1.2.tar.gz
Algorithm Hash digest
SHA256 0a9e9e9e21cf3ce5752f9685aa02a7d5fb690647fb9eca918cacd4da7e464ccd
MD5 ff1e65b5f07e4a28b410b973e49ac5a6
BLAKE2b-256 2a8c4411331293908f4546b68a8a2da82a3eb94a63cd3ae738875ff82e406ffa

See more details on using hashes here.

File details

Details for the file vllm_top-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: vllm_top-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 8.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.0

File hashes

Hashes for vllm_top-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 27b64ae88e33725a7f1d04879bf66932dadb2bb46ca422ea22b11e9b005024c4
MD5 efa77a83fce0ec4fd0a0b02c41cfe746
BLAKE2b-256 cf30dc990f9ecd1fc1fe5220849a429480dadc4a04cdfc80b2cc050e73ffc95c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page