Skip to main content

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

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

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 https://uwsgi-docs.readthedocs.io/en/latest/StatsServer.html

Project details


Download files

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

Source Distribution

uwsgitop-0.12.tar.gz (6.6 kB view details)

Uploaded Source

File details

Details for the file uwsgitop-0.12.tar.gz.

File metadata

  • Download URL: uwsgitop-0.12.tar.gz
  • Upload date:
  • Size: 6.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.11.8

File hashes

Hashes for uwsgitop-0.12.tar.gz
Algorithm Hash digest
SHA256 4f9330951f0fb9633226de36cf0c28c04dcf323efab608834aa81f638b6019b2
MD5 09f24d56aef9d3ebbd0ae9426562354a
BLAKE2b-256 5f3b02f373bc88978e8f1f33f5afe625ad28def59b6cfbf93424030754dbd5a5

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page