A cross-platform curses-based monitoring tool
Project description
Follow Glances on Twitter: @nicolargo or @glances_system
Glances - An eye on your system
Glances is a cross-platform curses-based system monitoring tool written in Python.
It uses the psutil library to get information from your system.
Requirements
- python >= 2.6 (tested with version 2.6, 2.7, 3.3, 3.4)
- psutil >= 2.0.0
- setuptools
Optional dependencies:
- bottle (for Web server mode)
- py3sensors (for hardware monitoring support) [Linux-only]
- hddtemp (for HDD temperature monitoring support) [Linux-only]
- batinfo (for battery monitoring support) [Linux-only]
- pysnmp (for SNMP support)
- zeroconf and netifaces (for the auto discoverer mode)
Installation
Glances Auto Install script
To install both dependacies and latest Glances version, just enter the following command line:
curl -L http://bit.ly/glances | /bin/bash
Note: Only supported on some GNU/Linux distributions. If you want to support others distribs, please contribute to glancesautoinstall.
PyPI: The simple way
Glances is on PyPI. By using PyPI, you are sure to have the latest stable version.
To install, simply use pip:
pip install Glances
Note: Python headers are required to install psutil. For example, on Debian/Ubuntu you need to install first the python-dev package.
To upgrade Glances to the latest version:
pip install --upgrade Glances
GNU/Linux
At the moment, packages exist for the following GNU/Linux distributions:
- Arch Linux
- Debian (Testing/Sid)
- Fedora/CentOS/RHEL
- Gentoo
- Slackware (SlackBuild)
- Ubuntu (13.04+)
- Void Linux
So you should be able to install it using your favorite package manager.
FreeBSD
To install the binary package:
# pkg_add -r py27-glances
Using pkgng:
# pkg install py27-glances
To install Glances from ports:
# cd /usr/ports/sysutils/py-glances/ # make install clean
OS X
OS X users can install Glances using Homebrew or MacPorts.
Homebrew
$ brew install python $ pip install Glances
MacPorts
$ sudo port install glances
Windows
- Install Python for Windows: http://www.python.org/getit/
- Install the psutil library: https://pypi.python.org/pypi?:action=display&name=psutil#downloads
- Install the colorconsole library: http://code.google.com/p/colorconsole/downloads/list
- Download Glances from here: http://nicolargo.github.io/glances/
Source
To install Glances version X.Y from source:
$ curl -L https://github.com/nicolargo/glances/archive/vX.Y.tar.gz -o glances-X.Y.tar.gz $ tar -zxvf glances-*.tar.gz $ cd glances-* # python setup.py install
Note: Python headers are required to install psutil. For example, on Debian/Ubuntu you need to install first the python-dev package.
Puppet
You can install Glances using Puppet: https://github.com/rverchere/puppet-glances
Usage
For the standalone mode, just run:
$ glances
For the Web server mode, run:
$ glances -w
and enter the URL http://<ip>:61208 in your favorite web browser.
For the client/server mode, run:
$ glances -s
on the server side and run:
$ glances -c <ip>
on the client one.
You can also detect and display all Glances servers available on your network or defined in the configuration file:
$ glances --browser
And RTFM, always.
Documentation
For complete documentation see glances-doc.
If you have any question (after RTFM !), please post it on the official Q&A forum.
Author
Nicolas Hennion (@nicolargo) <nicolas@nicolargo.com>
License
LGPL. See COPYING for more details.
Project details
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.