uwsgitop

What it is and what it does

uwsgitop is a command-line monitoring utility for uWSGI applications. It connects to uWSGI's stats server (either over a Unix socket or HTTP) and displays worker metrics in a real-time, top-like interface. The tool shows per-worker statistics including request count, requests per second, memory usage (RSS and VSZ), response times, and worker state (idle, busy, cheap mode, suspended, or handling signals). Workers are color-coded by state for quick visual scanning.

The package is designed for developers and operators who need to monitor uWSGI application performance without external monitoring infrastructure. It requires uWSGI to be started with the stats server enabled and offers keyboard shortcuts to toggle async core statistics, refresh speed, and quit. Memory reporting must be enabled in uWSGI configuration to see RSS and VSZ metrics.

Use it for:

• Monitor worker utilization and request throughput on a running uWSGI application during load testing or production incidents.
• Diagnose slow or stuck workers by observing per-worker response times and request counts in real time.
• Track memory consumption per worker to identify memory leaks or inefficient worker configurations.
• Observe worker state transitions (busy, idle, cheap mode, suspended) to understand application behavior under load.
• Quick ad-hoc performance inspection without setting up centralized monitoring or logging infrastructure.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A terminal monitoring tool that connects to uWSGI's stats server and displays real-time worker metrics in a top-like interface.

Yes, if you actively run uWSGI and need quick, local performance visibility. The permissive MIT license and zero runtime dependencies make installation low-risk. However, dormant maintenance (last release 865 days ago) and high install friction mean verify compatibility with your Python version and uWSGI release before relying on it for production monitoring. For long-term use, consider whether centralized monitoring tools better fit your infrastructure.

Install

uwsgitop on PyPI

pip install uwsgitop

uv add uwsgitop

poetry add uwsgitop

Installing uwsgitop

Before you install

High install friction: distributed as a source tarball with no runtime dependencies listed, suggesting potential compilation or setup requirements. Maintenance is dormant—last release was 2024-04-01, over 865 days ago, though the repository remains active with 507 stars.

License in practice

MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions.

Quickstart

pip install uwsgitop

# Start uWSGI with stats server:
# uwsgi --module myapp --socket :3030 --stats /tmp/stats.socket

# Monitor with uwsgitop:
uwsgitop /tmp/stats.socket

Requires a running uWSGI application with stats server enabled (via --stats or --stats-http flag).

Verify before relying

• Whether the package requires compilation or system libraries beyond what pip normally handles.
• Current compatibility with modern Python versions and recent uWSGI releases.
• Whether the dormant maintenance status means critical bugs or security issues are unlikely to be addressed.

Package facts

Evidence: uwsgitop-0.12.tar.gz

Tags

More Monitoring packages