uWSGI top-like interface
Project description
uwsgitop is a top-like command that uses the uWSGI Stats Server to monitor your uwsgi application.
To use uWSGI Stat Server simply use the stats option followed by a valid socket address, for example:
uwsgi --module myapp --socket :3030 --stats /tmp/stats.socket
To start monitoring your application with uwsgitop call it with the socket address like so:
uwsgitop /tmp/stats.socket
If you want the stats served over HTTP you will need to add the stats-http option in uWSGI:
uwsgi --module myapp --http :3030 --stats :3031 --stats-http
You’ll now need to call uwsgitop as:
uwsgitop http://127.0.0.1:3031
Installation
pip install uwsgitop
Usage
To display async core statistics (e.g. when using gevent) or to switch between core statistics display mode, press a. To refresh the screen super fast press f, and to quit, press q.
Field |
Description |
|---|---|
WID |
Worker ID |
% |
Worker usage |
PID |
Worker PID |
REQ |
How many requests worker did since worker (re)spawn |
RPS |
Requests per second |
EXC |
Exceptions |
STATUS |
Worker is busy or free to use? |
AVG |
Average request time |
RSS |
Worker RSS (Resident Set Size, see linux memory management) |
VSZ |
Worker VSZ (Virtual Memory Size, see linux memory management) |
TX |
How many data was transmitted by worker |
RunT |
How long worker is working |
Colors
Lines would be displayed in different colors:
default console text color, if the worker is idle
green, if the worker is busy
magenta, if the worker is in cheap mode
yellow, if the worker is handling an uwsgi signal
blue, if the worker is suspended
Remember to enable memory-report in your uwsgi configuration to see how much memory resources your uwsgi processes are consuming.
Further Reading
For more info on uWSGI Stats Server see http://projects.unbit.it/uwsgi/wiki/StatsServer
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file uwsgitop-0.10.tar.gz.
File metadata
- Download URL: uwsgitop-0.10.tar.gz
- Upload date:
- Size: 5.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 869241257bec68337c7fcd3632b437b657c84dc53ef0a5acb18ec5f89076f9c0 |
|
| MD5 | 1eea14895804f9dabd8b8867beb1ed7d |
|
| BLAKE2b-256 | 6008af014f46b41f3cd3671ababef211936f37313a7fac65b3f1c099dd620cb0 |
