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
::
pip install uwsgitop
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 | Number of requests the worker executed since last (re)spawn | +--------+---------------------------------------------------------------+ | RPS | Requests per second | +--------+---------------------------------------------------------------+ | EXC | Exceptions | +--------+---------------------------------------------------------------+ | SIG | Managed uwsgi signals | +--------+---------------------------------------------------------------+ | 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 much data was transmitted by the worker | +--------+---------------------------------------------------------------+ | ReSpwn | Respawn count | +--------+---------------------------------------------------------------+ | HC | Harakiri count | +--------+---------------------------------------------------------------+ | RunT | How long the worker has been running | +--------+---------------------------------------------------------------+ |LastSpwn| Last spawn time | +--------+---------------------------------------------------------------+
Lines would be displayed in different colors:
green, if the worker is busymagenta, if the worker is in cheap modeyellow, if the worker is handling an uwsgi signalblue, if the worker is suspendedRemember to enable memory-report in your uwsgi configuration to see how
much memory resources your uwsgi processes are consuming.
For more info on uWSGI Stats Server see https://uwsgi-docs.readthedocs.io/en/latest/StatsServer.html
FAQs
uWSGI top-like interface
We found that uwsgitop demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Fluent Assertions is facing backlash after dropping the Apache license for a commercial model, leaving users blindsided and questioning contributor rights.
Research
Security News
Socket researchers uncover the risks of a malicious Python package targeting Discord developers.
Security News
The UK is proposing a bold ban on ransomware payments by public entities to disrupt cybercrime, protect critical services, and lead global cybersecurity efforts.