Skip to main content

A cross-platform curses-based monitoring tool

Project description

https://api.flattr.com/button/flattr-badge-large.png https://travis-ci.org/nicolargo/glances.png?branch=master https://badge.fury.io/py/Glances.png https://pypip.in/d/Glances/badge.png

Glances - An eye on your system

https://raw.github.com/nicolargo/glances/master/docs/images/glances-white-256.png

Glances is a cross-platform curses-based monitoring tool written in Python.

It uses the psutil library to get information from your system.

https://raw.github.com/nicolargo/glances/master/docs/images/screenshot-wide.png

Requirements

  • python >= 2.6 (tested with version 2.6, 2.7, 3.2, 3.3)
  • psutil >= 0.4.1 (recommended version >= 0.6)
  • jinja (optional for HTML output)
  • pysensors (optional for HW monitoring support) [Linux-only]
  • hddtemp (optional for HDD temperature monitoring support)
  • batinfo (optional for battery monitoring support) [Linux-only]
  • setuptools

Installation

PyPI: The simple way

Glances is on PyPI. To install, simply use pip:

pip install Glances

Note:

On Debian/Ubuntu, you need to install first the python-dev package.

On CentOS/Fedora, you need to install first the python-devel package (from the EPEL repository).

To upgrade Glances to the latest version:

pip install --upgrade Glances

Linux

Actually, packages exist for Arch Linux, Fedora / CentOS / RHEL, Debian (Sid/Testing) and Ubuntu (13.04+), so you should be able to install it using your favorite package manager.

FreeBSD

To install the precompiled binary package:

# pkg_add -r py27-glances

To install Glances from ports:

# cd /usr/ports/sysutils/py-glances/
# make install clean

OS X

OS X users can also install Glances using Homebrew or MacPorts.

Homebrew
$ brew install brew-pip
$ export PYTHONPATH=$(brew --prefix)/lib/python2.7/site-packages
$ brew pip Glances

If you get the following error:

Error: Failed executing: pip install glances==X.X --install-option=--prefix=/usr/local/XXX/glances/X.X (.rb:)

Try to run:

$ pip install glances==X.X --install-option=--prefix=/usr/local/XXX/glances/X.X
$ brew link Glances
MacPorts
$ sudo port install glances

Windows

Windows only support Glances in server mode. Glances will automatically run in server mode on it.

Thanks to Nicolas Bourges, Glances can be easily installed using a Windows installer:

Otherwise, you have to follow these steps:

Source

To install Glances from source:

$ curl -L https://github.com/nicolargo/glances/archive/vX.X.tar.gz -o glances-X.X.tar.gz
$ tar -zxvf glances-*.tar.gz
$ cd glances-*
# python setup.py install

Note:

On Debian/Ubuntu, you need to install first the python-dev package.

On CentOS/Fedora, you need to install first the python-devel package (from the EPEL repository).

Puppet

You can install Glances using Puppet: https://github.com/rverchere/puppet-glances

Usage

Just run:

$ glances

Documentation

For complete documentation see glances-doc.

Author

Nicolas Hennion (@nicolargo) <nicolas@nicolargo.com>

License

LGPL. See COPYING for more details.

Project details


Download files

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

Files for Glances, version 1.7.1
Filename, size File type Python version Upload date Hashes
Filename, size Glances-1.7.1.tar.gz (1.2 MB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page