2013-12-26 14:03:50 +00:00
|
|
|
===============================
|
|
|
|
Glances - An eye on your system
|
|
|
|
===============================
|
|
|
|
|
2013-05-17 14:11:00 +00:00
|
|
|
.. image:: https://api.flattr.com/button/flattr-badge-large.png
|
2013-04-08 14:16:00 +00:00
|
|
|
:target: https://flattr.com/thing/484466/nicolargoglances-on-GitHub
|
2014-12-16 14:04:05 +00:00
|
|
|
.. image:: https://scrutinizer-ci.com/g/nicolargo/glances/badges/quality-score.png?b=master
|
|
|
|
:target: https://scrutinizer-ci.com/g/nicolargo/glances/
|
2013-04-08 14:16:00 +00:00
|
|
|
.. image:: https://travis-ci.org/nicolargo/glances.png?branch=master
|
|
|
|
:target: https://travis-ci.org/nicolargo/glances
|
2013-08-15 09:43:31 +00:00
|
|
|
.. image:: https://badge.fury.io/py/Glances.png
|
2013-10-28 12:13:13 +00:00
|
|
|
:target: http://badge.fury.io/py/Glances
|
2013-12-26 13:58:11 +00:00
|
|
|
.. image:: https://pypip.in/d/Glances/badge.png
|
|
|
|
:target: https://pypi.python.org/pypi/Glances/
|
|
|
|
:alt: Downloads
|
2015-01-31 15:52:58 +00:00
|
|
|
|
2015-01-10 15:36:53 +00:00
|
|
|
|
|
|
|
Follow Glances on Twitter: `@nicolargo`_ or `@glances_system`_
|
|
|
|
|
2014-06-08 18:44:49 +00:00
|
|
|
**Glances** is a cross-platform curses-based system monitoring tool
|
|
|
|
written in Python.
|
2013-04-08 14:16:00 +00:00
|
|
|
|
2013-05-17 14:11:00 +00:00
|
|
|
.. image:: https://raw.github.com/nicolargo/glances/master/docs/images/screenshot-wide.png
|
2013-04-08 14:16:00 +00:00
|
|
|
|
|
|
|
Requirements
|
|
|
|
============
|
|
|
|
|
2015-03-11 14:51:15 +00:00
|
|
|
- ``python >= 2.6`` or ``>= 3.3`` (tested with version 2.6, 2.7, 3.3, 3.4)
|
2014-05-11 17:55:55 +00:00
|
|
|
- ``psutil >= 2.0.0``
|
2013-04-08 14:16:00 +00:00
|
|
|
- ``setuptools``
|
|
|
|
|
2015-04-19 10:45:55 +00:00
|
|
|
Optional dependencies:
|
2014-01-19 17:59:59 +00:00
|
|
|
|
2014-06-08 18:44:49 +00:00
|
|
|
- ``bottle`` (for Web server mode)
|
2014-05-25 16:19:40 +00:00
|
|
|
- ``py3sensors`` (for hardware monitoring support) [Linux-only]
|
2014-06-08 18:44:49 +00:00
|
|
|
- ``hddtemp`` (for HDD temperature monitoring support) [Linux-only]
|
2014-01-19 17:59:59 +00:00
|
|
|
- ``batinfo`` (for battery monitoring support) [Linux-only]
|
2015-01-04 16:15:26 +00:00
|
|
|
- ``pymdstat`` (for RAID support) [Linux-only]
|
2014-06-08 18:44:49 +00:00
|
|
|
- ``pysnmp`` (for SNMP support)
|
2015-04-27 10:27:17 +00:00
|
|
|
- ``zeroconf`` (for the autodiscover mode)
|
|
|
|
- ``netifaces`` (for the IP plugin)
|
2014-12-29 21:20:27 +00:00
|
|
|
- ``influxdb`` (for the InfluxDB export module)
|
2015-01-02 22:31:05 +00:00
|
|
|
- ``statsd`` (for the StatsD export module)
|
|
|
|
- ``pystache`` (for the action script feature)
|
2015-01-04 19:59:04 +00:00
|
|
|
- ``docker-py`` (for the Docker monitoring support) [Linux-only]
|
2015-05-03 23:05:15 +00:00
|
|
|
- ``matplotlib`` (for graphical/chart support)
|
2015-05-06 13:16:10 +00:00
|
|
|
- ``pika`` (for the RabbitMQ/ActiveMQ export module)
|
2014-01-19 17:59:59 +00:00
|
|
|
|
2013-04-08 14:16:00 +00:00
|
|
|
Installation
|
|
|
|
============
|
|
|
|
|
2014-09-09 18:54:53 +00:00
|
|
|
Glances Auto Install script
|
|
|
|
---------------------------
|
|
|
|
|
2015-04-19 10:45:55 +00:00
|
|
|
To install both dependencies and latest Glances production ready version
|
|
|
|
(aka *master* branch), just enter the following command line:
|
2014-09-09 18:54:53 +00:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
curl -L http://bit.ly/glances | /bin/bash
|
|
|
|
|
2015-01-04 15:26:55 +00:00
|
|
|
or
|
2015-01-03 18:11:21 +00:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
wget -O- http://bit.ly/glances | /bin/bash
|
|
|
|
|
2015-01-04 16:15:26 +00:00
|
|
|
*Note*: Only supported on some GNU/Linux distributions. If you want to
|
|
|
|
support other distributions, please contribute to `glancesautoinstall`_.
|
2014-09-09 18:54:53 +00:00
|
|
|
|
2013-08-11 23:32:12 +00:00
|
|
|
PyPI: The simple way
|
2013-08-11 18:43:30 +00:00
|
|
|
--------------------
|
|
|
|
|
2015-01-04 15:26:55 +00:00
|
|
|
Glances is on ``PyPI``. By using PyPI, you are sure to have the latest
|
2014-06-08 18:44:49 +00:00
|
|
|
stable version.
|
2014-05-25 16:19:40 +00:00
|
|
|
|
2015-01-04 15:26:55 +00:00
|
|
|
To install, simply use ``pip``:
|
2013-07-13 22:44:00 +00:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2015-05-06 13:16:10 +00:00
|
|
|
pip install glances
|
2013-06-05 11:07:17 +00:00
|
|
|
|
2014-06-08 18:44:49 +00:00
|
|
|
*Note*: Python headers are required to install psutil. For example,
|
2014-05-11 17:55:55 +00:00
|
|
|
on Debian/Ubuntu you need to install first the *python-dev* package.
|
2014-05-11 15:11:17 +00:00
|
|
|
|
2015-04-19 10:45:55 +00:00
|
|
|
You can also install the following libraries in order to use optional
|
|
|
|
features:
|
2015-01-10 15:36:53 +00:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2015-05-06 13:16:10 +00:00
|
|
|
pip install bottle batinfo https://bitbucket.org/gleb_zhulik/py3sensors/get/tip.tar.gz zeroconf netifaces pymdstat influxdb statsd pystache pika
|
2015-01-10 15:36:53 +00:00
|
|
|
|
2013-08-11 18:43:30 +00:00
|
|
|
To upgrade Glances to the latest version:
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2015-05-06 13:16:10 +00:00
|
|
|
pip install --upgrade glances
|
2013-08-11 18:43:30 +00:00
|
|
|
|
2015-01-10 15:36:53 +00:00
|
|
|
If you need to install Glances in a specific user location, use:
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
export PYTHONUSERBASE=~/mylocalpath
|
2015-05-06 13:16:10 +00:00
|
|
|
pip install --user glances
|
2015-01-10 15:36:53 +00:00
|
|
|
|
2014-05-25 16:19:40 +00:00
|
|
|
GNU/Linux
|
|
|
|
---------
|
2013-07-13 22:44:00 +00:00
|
|
|
|
2014-05-25 16:19:40 +00:00
|
|
|
At the moment, packages exist for the following GNU/Linux distributions:
|
2014-01-19 17:59:59 +00:00
|
|
|
|
|
|
|
- Arch Linux
|
2015-05-06 13:16:10 +00:00
|
|
|
- Debian
|
2014-01-19 17:59:59 +00:00
|
|
|
- Fedora/CentOS/RHEL
|
|
|
|
- Gentoo
|
2014-11-29 13:12:25 +00:00
|
|
|
- Slackware (SlackBuild)
|
2015-05-06 13:16:10 +00:00
|
|
|
- Ubuntu
|
2014-01-19 17:59:59 +00:00
|
|
|
- Void Linux
|
|
|
|
|
|
|
|
So you should be able to install it using your favorite package manager.
|
2013-04-08 14:16:00 +00:00
|
|
|
|
2013-07-13 22:44:00 +00:00
|
|
|
FreeBSD
|
|
|
|
-------
|
|
|
|
|
2014-01-19 17:59:59 +00:00
|
|
|
To install the binary package:
|
2013-04-08 14:16:00 +00:00
|
|
|
|
2014-01-19 17:59:59 +00:00
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
# pkg install py27-glances
|
|
|
|
|
2013-07-13 22:44:00 +00:00
|
|
|
To install Glances from ports:
|
|
|
|
|
|
|
|
.. code-block:: console
|
2013-04-08 14:16:00 +00:00
|
|
|
|
2013-07-13 22:44:00 +00:00
|
|
|
# cd /usr/ports/sysutils/py-glances/
|
|
|
|
# make install clean
|
2013-06-05 11:07:17 +00:00
|
|
|
|
2013-04-08 14:16:00 +00:00
|
|
|
OS X
|
|
|
|
----
|
|
|
|
|
2015-01-04 15:26:55 +00:00
|
|
|
OS X users can install Glances using ``Homebrew`` or ``MacPorts``.
|
2013-04-08 14:16:00 +00:00
|
|
|
|
|
|
|
Homebrew
|
|
|
|
````````
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2013-12-17 08:31:43 +00:00
|
|
|
$ brew install python
|
2015-05-06 13:16:10 +00:00
|
|
|
$ pip install glances
|
2013-04-08 14:16:00 +00:00
|
|
|
|
|
|
|
MacPorts
|
|
|
|
````````
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
$ sudo port install glances
|
|
|
|
|
|
|
|
Windows
|
|
|
|
-------
|
|
|
|
|
2013-08-11 23:32:12 +00:00
|
|
|
- Install Python for Windows: http://www.python.org/getit/
|
2015-05-06 13:16:10 +00:00
|
|
|
- Install the psutil library (latest binary version): https://pypi.python.org/pypi?:action=display&name=psutil#downloads
|
2015-01-04 15:26:55 +00:00
|
|
|
- Install the colorconsole library: https://pypi.python.org/pypi/colorconsole
|
2015-05-06 13:16:10 +00:00
|
|
|
- Install Pip: http://pip.readthedocs.org/en/latest/installing.html
|
|
|
|
- Install optionnals dependencies (see list bellow)
|
|
|
|
- Install Glances using pip
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
$ pip install glances
|
2013-04-08 14:16:00 +00:00
|
|
|
|
|
|
|
Source
|
|
|
|
------
|
|
|
|
|
2015-01-04 16:15:26 +00:00
|
|
|
To install Glances from source:
|
2013-04-08 14:16:00 +00:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2014-05-21 12:43:00 +00:00
|
|
|
$ curl -L https://github.com/nicolargo/glances/archive/vX.Y.tar.gz -o glances-X.Y.tar.gz
|
2013-04-08 14:16:00 +00:00
|
|
|
$ tar -zxvf glances-*.tar.gz
|
|
|
|
$ cd glances-*
|
|
|
|
# python setup.py install
|
|
|
|
|
2014-05-11 17:55:55 +00:00
|
|
|
*Note*: Python headers are required to install psutil. For example,
|
|
|
|
on Debian/Ubuntu you need to install first the *python-dev* package.
|
2013-09-07 20:17:54 +00:00
|
|
|
|
2013-04-08 14:16:00 +00:00
|
|
|
Puppet
|
|
|
|
------
|
|
|
|
|
2015-01-04 15:26:55 +00:00
|
|
|
You can install Glances using ``Puppet``: https://github.com/rverchere/puppet-glances
|
2013-04-08 14:16:00 +00:00
|
|
|
|
|
|
|
Usage
|
|
|
|
=====
|
|
|
|
|
2014-05-25 16:19:40 +00:00
|
|
|
For the standalone mode, just run:
|
2013-04-08 14:16:00 +00:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2013-05-17 13:55:00 +00:00
|
|
|
$ glances
|
2013-04-08 14:16:00 +00:00
|
|
|
|
2014-05-25 16:19:40 +00:00
|
|
|
For the Web server mode, run:
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
$ glances -w
|
|
|
|
|
2014-06-08 18:44:49 +00:00
|
|
|
and enter the URL ``http://<ip>:61208`` in your favorite web browser.
|
2014-05-25 16:19:40 +00:00
|
|
|
|
|
|
|
For the client/server mode, run:
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
$ glances -s
|
|
|
|
|
|
|
|
on the server side and run:
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
$ glances -c <ip>
|
|
|
|
|
|
|
|
on the client one.
|
|
|
|
|
2015-01-04 16:15:26 +00:00
|
|
|
You can also detect and display all Glances servers available on your
|
|
|
|
network or defined in the configuration file:
|
2014-11-16 20:31:02 +00:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2014-11-29 09:17:39 +00:00
|
|
|
$ glances --browser
|
2014-11-16 20:31:02 +00:00
|
|
|
|
2015-01-04 16:15:26 +00:00
|
|
|
and RTFM, always.
|
2013-12-15 09:23:06 +00:00
|
|
|
|
2013-04-08 14:16:00 +00:00
|
|
|
Documentation
|
|
|
|
=============
|
|
|
|
|
2013-05-17 16:52:00 +00:00
|
|
|
For complete documentation see `glances-doc`_.
|
2013-04-08 14:16:00 +00:00
|
|
|
|
2015-01-04 16:15:26 +00:00
|
|
|
If you have any question (after RTFM!), please post it on the official Q&A `forum`_.
|
2014-09-13 07:25:42 +00:00
|
|
|
|
2015-01-10 15:36:53 +00:00
|
|
|
Gateway to other services
|
|
|
|
=========================
|
|
|
|
|
2015-05-06 13:16:10 +00:00
|
|
|
Glances can export stats to: ``CSV`` file, ``InfluxDB``, ``StatsD`` and ``RabbitMQ`` server.
|
2015-01-10 15:36:53 +00:00
|
|
|
|
2015-01-31 12:45:48 +00:00
|
|
|
How to contribute ?
|
|
|
|
===================
|
|
|
|
|
|
|
|
If you want to contribute to the Glances project, read this `Wiki`_ page.
|
|
|
|
|
2015-04-19 10:45:55 +00:00
|
|
|
There is also a chat dedicated to the Glances developers:
|
2015-01-31 12:45:48 +00:00
|
|
|
|
|
|
|
.. image:: https://badges.gitter.im/Join%20Chat.svg
|
|
|
|
:target: https://gitter.im/nicolargo/glances?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
|
|
|
|
|
2013-04-08 14:16:00 +00:00
|
|
|
Author
|
|
|
|
======
|
|
|
|
|
|
|
|
Nicolas Hennion (@nicolargo) <nicolas@nicolargo.com>
|
|
|
|
|
|
|
|
License
|
|
|
|
=======
|
|
|
|
|
|
|
|
LGPL. See ``COPYING`` for more details.
|
|
|
|
|
2015-01-04 15:26:55 +00:00
|
|
|
.. _psutil: https://github.com/giampaolo/psutil
|
2014-09-09 18:54:53 +00:00
|
|
|
.. _glancesautoinstall: https://github.com/nicolargo/glancesautoinstall
|
2013-12-21 12:13:51 +00:00
|
|
|
.. _@nicolargo: https://twitter.com/nicolargo
|
|
|
|
.. _@glances_system: https://twitter.com/glances_system
|
2013-05-17 16:52:00 +00:00
|
|
|
.. _glances-doc: https://github.com/nicolargo/glances/blob/master/docs/glances-doc.rst
|
2014-09-13 07:25:42 +00:00
|
|
|
.. _forum: https://groups.google.com/forum/?hl=en#!forum/glances-users
|
2015-01-31 12:50:06 +00:00
|
|
|
.. _Wiki: https://github.com/nicolargo/glances/wiki/How-to-contribute-to-Glances-%3F
|