Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

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 History

This version
History Node

0.10

History Node

0.9

History Node

0.8

History Node

0.6.2

History Node

0.6.1

History Node

0.6

History Node

0.5

History Node

0.4.1

History Node

0.4

History Node

0.3

History Node

0.2.2

History Node

0.2.1

History Node

0.2

History Node

0.1

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
uwsgitop-0.10.tar.gz (5.9 kB) Copy SHA256 Checksum SHA256 Source Dec 29, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting