Follow Glances on Twitter: @nicolargo or @glances_system
Glances is a cross-platform system monitoring tool written in Python.
Requirements
python 2.7,>=3.3
(tested with version 2.7, 3.3, 3.4, 3.5)psutil>=2.0.0
setuptools
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]pymdstat
(for RAID support) [Linux-only]pysnmp
(for SNMP support)zeroconf
(for the autodiscover mode)netifaces
(for the IP plugin)influxdb
(for the InfluxDB export module)statsd
(for the StatsD export module)pystache
(for the action script feature)docker-py
(for the Docker monitoring support) [Linux-only]matplotlib
(for graphical/chart support)pika
(for the RabbitMQ/ActiveMQ export module)bernhard
(for the Riemann export module)py-cpuinfo
(for the Quicklook CPU info module)scandir
(for the Folders plugin) [Only for Python < 3.5]
Since version 2.7, Glances no longer support Python 2.6. Please upgrade to at least Python 2.7/3.3+ or downgrade to Glances 2.6.2 (latest version with Python 2.6 support).
Note for CentOS Linux 6 and 7 users
Python 2.7, 3.3 and 3.4 are now available via SCLs. See: https://lists.centos.org/pipermail/centos-announce/2015-December/021555.html.
Several method to test/install Glances on your system. Choose your weapon ! Installation
To install both dependencies and latest Glances production ready version (aka master branch), just enter the following command line: Glances Auto Install script: the total way
curl -L https://bit.ly/glances | /bin/bash
wget -O- https://bit.ly/glances | /bin/bash
Glances is on PyPI: The simple way
PyPI
. By using PyPI, you are sure to have the latest
stable version.To install, simply use
pip
:pip install glances
You can also install the following libraries in order to use optional features (like the Web interface, exports modules, sensors...):
pip install bottle requests batinfo https://bitbucket.org/gleb_zhulik/py3sensors/get/tip.tar.gz zeroconf netifaces pymdstat influxdb elasticsearch potsdb statsd pystache docker-py pysnmp pika py-cpuinfo bernhard cassandra scandir
pip install --upgrade glances
export PYTHONUSERBASE=~/mylocalpath
pip install --user glances
A Glances container is available. It will include the latest development HEAD version. You can use it to monitor your server and all your others containers ! Docker: the funny way
Get the Glances container:
docker pull nicolargo/glances
docker run -v /var/run/docker.sock:/var/run/docker.sock:ro --pid host -it docker.io/nicolargo/glances
docker run -d -p 61208:61208 -e GLANCES_OPT="-w" -v /var/run/docker.sock:/var/run/docker.sock:ro --pid host docker.io/nicolargo/glances
FROM nicolargo/glances
COPY glances.conf /glances/conf/glances.conf
CMD python -m glances -C /glances/conf/glances.conf $GLANCES_OPT
docker run -v ./glances.conf:/glances/conf/glances.conf -v /var/run/docker.sock:/var/run/docker.sock:ro --pid host -it docker.io/nicolargo/glances
At the moment, packages exist for the following GNU/Linux distributions: GNU/Linux
- Arch Linux
- Debian
- Fedora/CentOS/RHEL
- Gentoo
- Slackware (SlackBuild)
- Ubuntu
- Void Linux
To install the binary package: FreeBSD
# pkg install py27-glances
# cd /usr/ports/sysutils/py-glances/
# make install clean
OS X users can install Glances using OS X
Homebrew
or MacPorts
.Homebrew
$ brew install python
$ pip install glances
MacPorts
$ sudo port install glances
Install WindowsPython for Windows (Python 2.7.9+ and 3.4+ ship with pip) and then just:
$ pip install glances
pip install bottle requests zeroconf netifaces influxdb elasticsearch potsdb statsd pystache pysnmp pika py-cpuinfo bernhard cassandra scandir
To install Glances from source: Source
$ wget https://github.com/nicolargo/glances/archive/vX.Y.tar.gz -O - | tar xz
$ cd glances-*
# python setup.py install
An awesome Chef
Chef
cookbook is available to monitor your infrastructure: https://supermarket.chef.io/cookbooks/glances (thanks to Antoine Rouyer)You can install Glances using Puppet
Puppet
: https://github.com/rverchere/puppet-glancesFor the standalone mode, just run: Usage
$ glances
$ glances -w
http://<ip>:61208
in your favorite web browser.For the client/server mode, run:
$ glances -s
$ glances -c <ip>
You can also detect and display all Glances servers available on your network or defined in the configuration file:
$ glances --browser
For complete documentation have a look at the Documentationreadthedocs website.
If you have any question (after RTFM!), please post it on the official Q&A forum.
Glances can export stats to: Gateway to other services
CSV
file, InfluxDB
, Cassandra
,
OpenTSDB
, StatsD
, ElasticSearch
, RabbitMQ
and Riemann
server.If you want to contribute to the Glances project, read this How to contribute ?wiki page.
There is also a chat dedicated to the Glances developers:
from https://github.com/nicolargo/glances