Glances an Eye on your system. A top/htop alternative for GNU/Linux, BSD, Mac OS and Windows operating systems.
Go to file
2011-12-13 21:57:51 +01:00
m4 First public release 2011-12-04 09:52:09 +01:00
man version 1.3 2011-12-13 21:57:51 +01:00
src version 1.3 2011-12-13 21:57:51 +01:00
AUTHORS First public release 2011-12-04 09:52:09 +01:00
autogen.sh First public release 2011-12-04 09:52:09 +01:00
ChangeLog First public release 2011-12-04 09:52:09 +01:00
config.h.in First public release 2011-12-04 09:52:09 +01:00
configure.ac version 1.3 2011-12-13 21:57:51 +01:00
COPYING First public release 2011-12-04 09:52:09 +01:00
Makefile.am version 1.3 2011-12-13 21:57:51 +01:00
Makefile.in version 1.3 2011-12-13 21:57:51 +01:00
NEWS version 1.3 2011-12-13 21:57:51 +01:00
README version 1.3 2011-12-13 21:57:51 +01:00
README.md version 1.2 2011-12-10 22:44:49 +01:00
screenshot.png 1.1 screenshot 2011-12-05 11:55:32 +01:00
setup.py version 1.3 2011-12-13 21:57:51 +01:00
TODO version 1.3 2011-12-13 21:57:51 +01:00

Glances -- Eye on your system

Description

Glances is a CLI curses based monitoring tool for both GNU/Linux and BSD.

Glances uses the libstatgrab library to get information from your system. Glances is developed in Python and uses the python-statgrab lib.

screenshot

Installation

Get the latest version:

$ wget https://github.com/downloads/nicolargo/glances/glances-1.3.tar.gz

Glances use a standard GNU style installer:

$ tar zxvf glances-1.3.tar.gz
$ cd glances-1.3
$ ./configure
$ make
$ sudo make install

Pre-requisites:

  • Python 2.6+ (not tested with Python 3+)
  • python-statgrab 0.5+ (did not work with python-statgrab 0.4)

Notes: The Debian Squeeze repos only include the python-statgrab 0.4. You had to install the version 0.5 using the following commands:

$ sudo apt-get install libstatgrab-dev pkg-config python-dev make
$ wget http://ftp.uk.i-scream.org/sites/ftp.i-scream.org/pub/i-scream/pystatgrab/pystatgrab-0.5.tar.gz
$ tar zxvf pystatgrab-0.5.tar.gz
$ cd pystatgrab-0.5/
$ ./setup.py build
$ sudo ./setup.py install

Notes: Ubuntu 10.04 and 10.10. The instruction to install the version 0.5 are here: https://github.com/nicolargo/glances/issues/5#issuecomment-3033194

Running

Easy:

$ glances.py

User guide

By default, stats are refrsh every second, to change this setting, you can use the -t option. For exemple to set the refrech rate to 5 seconds:

$ glances.py -t 5

Importants stats are colored:

  • GREEN: stat counter is < 50%
  • BLUE: stat counter is > 50% and < 70%
  • MAGENTA: stat counter is > 70% and < 90%
  • RED: stat counter is > 90%

When Glances is running, you can press:

  • 'a' to set the automatic mode. The process list is sorted automatically

    If CPU > 70%, sort by process CPU consomption

    If MEM > 70%, sort by process size

  • 'c' the processes list is sorted by CPU consomption

  • 'm' the processes list is sorted by process size

  • 'q' Exit

Limitation

The current version of the python-statgrab API can not retrieve the file system statistics. https://bugs.launchpad.net/ubuntu/+source/libstatgrab/+bug/886783

Todo

You are welcome to contribute to this software.

  • Packaging for Debian, Ubuntu, Fedora, Redhat, BSD...
  • Check the needed Python library in the configure.ac
  • Add file system stats when the python-statgrab is corrected
  • Add a user guide window