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


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.

Source Distribution

Glances-1.7.1.tar.gz (1.2 MB view hashes)

Uploaded Source

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