uwsgitop is a command-line tool that provides a 'top-like' interface for real-time monitoring of uWSGI applications. It connects to the uWSGI Stats Server to display worker statistics, memory usage, request rates, and other vital metrics in a curses-based terminal view. The current version is 0.12, and while functional, the project exhibits a slow release cadence, primarily for maintenance rather than active feature development.
pip install uwsgitopNo compatibility data collected yet for this library.
To use uwsgitop, you must first enable the Stats Server in your uWSGI configuration. This can be done via a UNIX socket or an HTTP address. Then, execute the `uwsgitop` command, providing the address of the uWSGI Stats Server.
Add `stats = /path/to/stats.socket` or `stats = 0.0.0.0:1717 --stats-http` to your uWSGI configuration.
Add `memory-report = true` to your uWSGI configuration.
For historical data, consider integrating uWSGI Stats Server with tools like Telegraf, InfluxDB, and Grafana.
Set appropriate permissions in your uWSGI config using `chmod-socket = 666` (or more restrictive `660` if the user is in the correct group) or ensure `uwsgitop` is run by the same user/group as uWSGI.
Verify your uWSGI configuration includes `stats` (e.g., `stats = /tmp/stats.socket` or `stats = 127.0.0.1:1717 --stats-http`). Ensure uWSGI is running and the specified stats address is correct and accessible from where `uwsgitop` is executed.
Ensure your uWSGI configuration has `processes = X` (where X > 1) and that the Stats Server is properly configured. For Emperor mode, individual vassals might need their own stats sockets, or you might need to use a custom solution to aggregate stats.
If connecting to an HTTP address, ensure `stats-http` is enabled in uWSGI config. Double-check the address/port to ensure it's exclusively used by the uWSGI Stats Server and that the uWSGI instance is healthy.