2013-12-26 18:03:50 +04:00
|
|
|
===============================
|
|
|
|
Glances - An eye on your system
|
|
|
|
===============================
|
|
|
|
|
2015-11-26 13:24:55 +03:00
|
|
|
.. image:: https://img.shields.io/pypi/v/glances.svg
|
|
|
|
:target: https://pypi.python.org/pypi/Glances
|
2017-01-07 12:26:53 +03:00
|
|
|
|
2015-10-03 17:28:55 +03:00
|
|
|
.. image:: https://img.shields.io/github/stars/nicolargo/glances.svg
|
|
|
|
:target: https://github.com/nicolargo/glances/
|
|
|
|
:alt: Github stars
|
2017-01-07 12:26:53 +03:00
|
|
|
|
2020-11-07 11:42:08 +03:00
|
|
|
.. image:: https://img.shields.io/docker/pulls/nicolargo/glances
|
|
|
|
:target: https://hub.docker.com/r/nicolargo/glances/
|
|
|
|
:alt: Docker pull
|
|
|
|
|
2018-12-30 01:22:39 +03:00
|
|
|
.. image:: https://pepy.tech/badge/glances/month
|
|
|
|
:target: https://pepy.tech/project/glances
|
2020-11-07 11:42:08 +03:00
|
|
|
:alt: Pypi downloads
|
2018-12-30 01:22:39 +03:00
|
|
|
|
2021-11-21 13:31:32 +03:00
|
|
|
.. image:: https://github.com/nicolargo/glances/actions/workflows/test.yml/badge.svg
|
|
|
|
:target: https://github.com/nicolargo/glances/actions
|
|
|
|
:alt: Linux tests (GitHub Actions)
|
2017-01-07 12:26:53 +03:00
|
|
|
|
2022-07-27 11:03:35 +03:00
|
|
|
.. image:: https://img.shields.io/github/contributors/nicolargo/glances
|
|
|
|
:target: https://github.com/nicolargo/glances/issues?q=is%3Aissue+is%3Aopen+label%3A%22needs+contributor%22
|
|
|
|
:alt: Contibutors
|
2017-01-07 12:26:53 +03:00
|
|
|
|
2018-12-31 13:36:08 +03:00
|
|
|
.. image:: https://scrutinizer-ci.com/g/nicolargo/glances/badges/quality-score.png?b=develop
|
|
|
|
:target: https://scrutinizer-ci.com/g/nicolargo/glances/?branch=develop
|
2022-07-27 11:03:35 +03:00
|
|
|
:alt: Code quality
|
2015-01-10 18:36:53 +03:00
|
|
|
|
2022-07-27 11:03:35 +03:00
|
|
|
.. image:: https://img.shields.io/github/sponsors/nicolargo
|
2020-11-20 09:46:10 +03:00
|
|
|
:target: https://github.com/sponsors/nicolargo
|
2022-07-27 11:03:35 +03:00
|
|
|
:alt: Sponsors
|
2018-12-31 13:37:29 +03:00
|
|
|
|
2018-12-31 13:36:08 +03:00
|
|
|
.. image:: https://img.shields.io/twitter/url/https/twitter.com/cloudposse.svg?style=social&label=Follow%20%40nicolargo
|
|
|
|
:target: https://twitter.com/nicolargo
|
2022-07-27 11:03:35 +03:00
|
|
|
:alt: @nicolargo
|
2017-04-08 19:37:18 +03:00
|
|
|
|
2017-01-07 17:55:32 +03:00
|
|
|
Summary
|
|
|
|
=======
|
|
|
|
|
2023-01-21 13:37:22 +03:00
|
|
|
**Glances** is an open-source system cross-platform monitoring tool.
|
|
|
|
It allows real-time monitoring of various aspects of your system such as
|
|
|
|
CPU, memory, disk, network usage etc. It also allows monitoring of running processes,
|
|
|
|
logged in users, temperatures, voltages, fan speeds etc.
|
|
|
|
It also supports container monitoring, it supports different container management
|
|
|
|
systems such as Docker, LXC. The information is presented in an easy to read dashboard
|
|
|
|
and can also be used for remote monitoring of systems via a web interface or command
|
|
|
|
line interface. It is easy to install and use and can be customized to show only
|
|
|
|
the information that you are interested in.
|
2017-01-07 17:55:32 +03:00
|
|
|
|
|
|
|
.. image:: https://raw.githubusercontent.com/nicolargo/glances/develop/docs/_static/glances-summary.png
|
|
|
|
|
2023-01-21 13:37:22 +03:00
|
|
|
In client/server mode, remote monitoring could be done via terminal,
|
|
|
|
Web interface or API (XML-RPC and RESTful).
|
|
|
|
Stats can also be exported to files or external time/value databases, CSV or direct
|
|
|
|
output to STDOUT.
|
2017-01-07 17:55:32 +03:00
|
|
|
|
|
|
|
.. image:: https://raw.githubusercontent.com/nicolargo/glances/develop/docs/_static/glances-responsive-webdesign.png
|
2013-04-08 18:16:00 +04:00
|
|
|
|
2017-01-21 21:16:15 +03:00
|
|
|
Glances is written in Python and uses libraries to grab information from
|
|
|
|
your system. It is based on an open architecture where developers can
|
|
|
|
add new plugins or exports modules.
|
2013-04-08 18:16:00 +04:00
|
|
|
|
2022-11-01 12:38:37 +03:00
|
|
|
Project sponsorship
|
|
|
|
===================
|
2022-11-01 12:31:41 +03:00
|
|
|
|
2022-11-01 12:38:37 +03:00
|
|
|
You can help me to achieve my goals of improving this open-source project
|
|
|
|
or just say "thank you" by:
|
2022-11-01 12:31:41 +03:00
|
|
|
|
2022-11-01 12:33:01 +03:00
|
|
|
- sponsor me using one-time or monthly tier Github sponsors_ page
|
2022-11-01 12:38:37 +03:00
|
|
|
- send me some pieces of bitcoin: 185KN9FCix3svJYp7JQM7hRMfSKyeaJR4X
|
2022-11-01 12:33:01 +03:00
|
|
|
- buy me a gift on my wishlist_ page
|
2022-11-01 12:31:41 +03:00
|
|
|
|
|
|
|
Any and all contributions are greatly appreciated.
|
|
|
|
|
2013-04-08 18:16:00 +04:00
|
|
|
Requirements
|
|
|
|
============
|
|
|
|
|
2023-05-16 11:51:17 +03:00
|
|
|
- ``python>=3.8`` (use Glances 3.4.x for lower Python version)
|
2018-02-15 20:15:18 +03:00
|
|
|
- ``psutil>=5.3.0`` (better with latest version)
|
2021-08-03 12:19:16 +03:00
|
|
|
- ``defusedxml`` (in order to monkey patch xmlrpc)
|
2022-11-19 17:27:12 +03:00
|
|
|
- ``ujson`` (an optimized alternative to the standard json module)
|
2013-04-08 18:16:00 +04:00
|
|
|
|
2021-08-28 11:23:19 +03:00
|
|
|
*Note for Python 2 users*
|
2021-05-02 17:27:52 +03:00
|
|
|
|
2023-05-16 11:51:17 +03:00
|
|
|
Glances version 4 or higher do not support Python 2 (and Python 3 < 3.8).
|
|
|
|
Please uses Glances version 3.4.x if you need Python 2 support.
|
2021-07-09 11:03:37 +03:00
|
|
|
|
2015-04-19 13:45:55 +03:00
|
|
|
Optional dependencies:
|
2014-01-19 21:59:59 +04:00
|
|
|
|
2022-10-16 16:30:33 +03:00
|
|
|
- ``batinfo`` (for battery monitoring)
|
2017-01-01 16:14:20 +03:00
|
|
|
- ``bernhard`` (for the Riemann export module)
|
2016-09-11 21:18:03 +03:00
|
|
|
- ``cassandra-driver`` (for the Cassandra export module)
|
2021-02-28 12:19:33 +03:00
|
|
|
- ``chevron`` (for the action script feature)
|
2023-05-16 11:51:17 +03:00
|
|
|
- ``docker`` (for the Containers Docker monitoring support)
|
2017-01-01 16:14:20 +03:00
|
|
|
- ``elasticsearch`` (for the Elastic Search export module)
|
2023-11-26 12:02:30 +03:00
|
|
|
- ``FastAPI`` and ``Uvicorn`` (for Web server mode)
|
2021-05-11 09:52:03 +03:00
|
|
|
- ``graphitesender`` (For the Graphite export module)
|
2017-01-01 16:14:20 +03:00
|
|
|
- ``hddtemp`` (for HDD temperature monitoring support) [Linux-only]
|
2020-12-24 12:06:17 +03:00
|
|
|
- ``influxdb`` (for the InfluxDB version 1 export module)
|
2023-05-16 11:51:17 +03:00
|
|
|
- ``influxdb-client`` (for the InfluxDB version 2 export module)
|
2023-11-27 00:40:36 +03:00
|
|
|
- ``jinja2`` (for templating, used under the hood by FastAPI)
|
2017-03-27 12:05:43 +03:00
|
|
|
- ``kafka-python`` (for the Kafka export module)
|
2017-01-01 16:14:20 +03:00
|
|
|
- ``netifaces`` (for the IP plugin)
|
2023-11-27 00:40:36 +03:00
|
|
|
- ``orjson`` (fast JSON library, used under the hood by FastAPI)
|
2021-08-28 11:23:19 +03:00
|
|
|
- ``py3nvml`` (for the GPU plugin)
|
2023-10-08 11:10:13 +03:00
|
|
|
- ``pycouchdb`` (for the CouchDB export module)
|
2015-05-06 16:16:10 +03:00
|
|
|
- ``pika`` (for the RabbitMQ/ActiveMQ export module)
|
2023-05-16 11:51:17 +03:00
|
|
|
- ``podman`` (for the Containers Podman monitoring support)
|
2017-01-01 16:14:20 +03:00
|
|
|
- ``potsdb`` (for the OpenTSDB export module)
|
2017-03-27 12:05:43 +03:00
|
|
|
- ``prometheus_client`` (for the Prometheus export module)
|
2015-09-28 22:21:21 +03:00
|
|
|
- ``py-cpuinfo`` (for the Quicklook CPU info module)
|
2018-03-24 19:09:10 +03:00
|
|
|
- ``pygal`` (for the graph export module)
|
2017-01-01 16:14:20 +03:00
|
|
|
- ``pymdstat`` (for RAID support) [Linux-only]
|
2023-05-16 11:51:17 +03:00
|
|
|
- ``pymongo`` (for the MongoDB export module)
|
2017-01-01 16:14:20 +03:00
|
|
|
- ``pysnmp`` (for SNMP support)
|
2021-04-21 11:32:44 +03:00
|
|
|
- ``pySMART.smartx`` (for HDD Smart support) [Linux-only]
|
2017-01-01 16:14:20 +03:00
|
|
|
- ``pyzmq`` (for the ZeroMQ export module)
|
2018-02-15 21:45:45 +03:00
|
|
|
- ``requests`` (for the Ports, Cloud plugins and RESTful export module)
|
2021-04-21 11:32:44 +03:00
|
|
|
- ``sparklines`` (for the Quick Plugin sparklines option)
|
2017-01-01 16:14:20 +03:00
|
|
|
- ``statsd`` (for the StatsD export module)
|
2016-10-21 23:11:13 +03:00
|
|
|
- ``wifi`` (for the wifi plugin) [Linux-only]
|
2017-01-01 16:14:20 +03:00
|
|
|
- ``zeroconf`` (for the autodiscover mode)
|
2014-01-19 21:59:59 +04:00
|
|
|
|
2013-04-08 18:16:00 +04:00
|
|
|
Installation
|
|
|
|
============
|
|
|
|
|
2017-09-21 14:26:43 +03:00
|
|
|
There are several methods to test/install Glances on your system. Choose your weapon!
|
2016-02-05 18:16:40 +03:00
|
|
|
|
2021-08-14 19:09:46 +03:00
|
|
|
PyPI: The standard way
|
|
|
|
----------------------
|
2013-08-11 22:43:30 +04:00
|
|
|
|
2017-09-21 14:26:43 +03:00
|
|
|
Glances is on ``PyPI``. By using PyPI, you will be using the latest
|
2014-06-08 22:44:49 +04:00
|
|
|
stable version.
|
2014-05-25 20:19:40 +04:00
|
|
|
|
2021-05-02 17:27:52 +03:00
|
|
|
To install Glances, simply use ``pip``:
|
2013-07-14 02:44:00 +04:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2021-05-02 17:27:52 +03:00
|
|
|
pip install --user glances
|
2013-06-05 15:07:17 +04:00
|
|
|
|
2021-07-04 17:11:37 +03:00
|
|
|
*Note*: Python headers are required to install `psutil`_, a Glances
|
2023-09-26 19:37:02 +03:00
|
|
|
dependency. For example, on Debian/Ubuntu **the simplest** is ``apt install python3-psutil`` or alternatively need to install first
|
|
|
|
the *python-dev* package and gcc (*python-devel* on Fedora/CentOS/RHEL).
|
2021-05-02 17:27:52 +03:00
|
|
|
For Windows, just install psutil from the binary installation file.
|
2014-05-11 19:11:17 +04:00
|
|
|
|
2017-01-26 11:57:26 +03:00
|
|
|
*Note 2 (for the Wifi plugin)*: If you want to use the Wifi plugin, you need
|
|
|
|
to install the *wireless-tools* package on your system.
|
|
|
|
|
2022-07-28 11:30:55 +03:00
|
|
|
By default, Glances is installed without the Web interface dependencies.
|
|
|
|
To install it, use the following command:
|
2015-01-10 18:36:53 +03:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2022-07-28 11:30:55 +03:00
|
|
|
pip install --user 'glances[web]'
|
2013-08-11 22:43:30 +04:00
|
|
|
|
2022-10-16 16:30:33 +03:00
|
|
|
For a full installation (with all features):
|
2015-01-10 18:36:53 +03:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2023-05-08 16:51:57 +03:00
|
|
|
pip install --user 'glances[all]'
|
2015-01-10 18:36:53 +03:00
|
|
|
|
2022-07-28 11:30:55 +03:00
|
|
|
To upgrade Glances to the latest version:
|
2021-05-02 17:27:52 +03:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2022-07-28 11:30:55 +03:00
|
|
|
pip install --user --upgrade glances
|
2021-05-02 17:27:52 +03:00
|
|
|
|
2022-07-28 11:30:55 +03:00
|
|
|
The current develop branch is published to the test.pypi.org package index.
|
|
|
|
If you want to test the develop version (could be instable), enter:
|
2020-08-22 15:34:00 +03:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2021-05-02 17:27:52 +03:00
|
|
|
pip install --user -i https://test.pypi.org/simple/ Glances
|
|
|
|
|
2021-08-14 19:09:46 +03:00
|
|
|
Glances Auto Install script: the easy way
|
|
|
|
-----------------------------------------
|
2021-05-02 17:27:52 +03:00
|
|
|
|
|
|
|
To install both dependencies and the latest Glances production ready version
|
|
|
|
(aka *master* branch), just enter the following command line:
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
curl -L https://bit.ly/glances | /bin/bash
|
|
|
|
|
|
|
|
or
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
wget -O- https://bit.ly/glances | /bin/bash
|
|
|
|
|
|
|
|
*Note*: This is only supported on some GNU/Linux distributions and Mac OS X.
|
|
|
|
If you want to support other distributions, please contribute to `glancesautoinstall`_.
|
2020-08-22 15:34:00 +03:00
|
|
|
|
2021-08-14 19:09:46 +03:00
|
|
|
Docker: the fun way
|
|
|
|
-------------------
|
2016-02-05 18:16:40 +03:00
|
|
|
|
2022-11-03 17:05:57 +03:00
|
|
|
Glances Docker images are availables. You can use it to monitor your
|
|
|
|
server and all your containers !
|
2016-02-05 18:16:40 +03:00
|
|
|
|
2021-05-02 17:27:52 +03:00
|
|
|
Get the Glances container:
|
2016-02-05 18:16:40 +03:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2022-11-03 17:05:57 +03:00
|
|
|
docker pull nicolargo/glances:latest-full
|
2020-10-03 11:12:56 +03:00
|
|
|
|
2022-10-03 16:53:24 +03:00
|
|
|
The following tags are availables:
|
2020-10-03 11:12:56 +03:00
|
|
|
|
2022-11-03 17:05:57 +03:00
|
|
|
- *latest-full* for a full Alpine Glances image (latest release) with all dependencies
|
2023-11-26 12:02:30 +03:00
|
|
|
- *latest* for a basic Alpine Glances (latest release) version with minimal dependencies (FastAPI and Docker)
|
2022-11-03 17:05:57 +03:00
|
|
|
- *dev* for a basic Alpine Glances image (based on development branch) with all dependencies (Warning: may be instable)
|
2023-05-15 11:03:33 +03:00
|
|
|
- *ubuntu-latest-full* for a full Ubuntu Glances image (latest release) with all dependencies
|
2023-11-26 12:02:30 +03:00
|
|
|
- *ubuntu-latest* for a basic Ubuntu Glances (latest release) version with minimal dependencies (FastAPI and Docker)
|
2023-05-15 11:03:33 +03:00
|
|
|
- *ubuntu-dev* for a basic Ubuntu Glances image (based on development branch) with all dependencies (Warning: may be instable)
|
2021-08-14 19:14:22 +03:00
|
|
|
|
|
|
|
Run last version of Glances container in *console mode*:
|
2016-02-05 18:16:40 +03:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2023-05-16 12:03:02 +03:00
|
|
|
docker run --rm -e TZ="${TZ}" -v /var/run/docker.sock:/var/run/docker.sock:ro -v /run/user/1000/podman/podman.sock:/run/user/1000/podman/podman.sock:ro --pid host --network host -it nicolargo/glances:latest-full
|
2016-07-29 22:29:44 +03:00
|
|
|
|
2017-01-21 21:16:15 +03:00
|
|
|
Additionally, if you want to use your own glances.conf file, you can
|
|
|
|
create your own Dockerfile:
|
2016-05-27 14:28:51 +03:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2021-05-02 17:27:52 +03:00
|
|
|
FROM nicolargo/glances:latest
|
2022-05-25 23:40:38 +03:00
|
|
|
COPY glances.conf /etc/glances.conf
|
|
|
|
CMD python -m glances -C /etc/glances.conf $GLANCES_OPT
|
2016-05-27 14:28:51 +03:00
|
|
|
|
2017-01-21 21:16:15 +03:00
|
|
|
Alternatively, you can specify something along the same lines with
|
2022-07-15 20:25:53 +03:00
|
|
|
docker run options (notice the `GLANCES_OPT` environment
|
|
|
|
variable setting parameters for the glances startup command):
|
2016-05-27 14:28:51 +03:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2023-05-16 12:03:02 +03:00
|
|
|
docker run -e TZ="${TZ}" -v `pwd`/glances.conf:/etc/glances.conf -v /var/run/docker.sock:/var/run/docker.sock:ro -v /run/user/1000/podman/podman.sock:/run/user/1000/podman/podman.sock:ro --pid host -e GLANCES_OPT="-C /etc/glances.conf" -it nicolargo/glances:latest-full
|
2016-05-27 14:28:51 +03:00
|
|
|
|
2018-11-28 01:06:03 +03:00
|
|
|
Where \`pwd\`/glances.conf is a local directory containing your glances.conf file.
|
2016-02-05 18:16:40 +03:00
|
|
|
|
2022-07-15 20:25:53 +03:00
|
|
|
Run the container in *Web server mode*:
|
2016-09-20 11:41:08 +03:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2023-05-16 12:03:02 +03:00
|
|
|
docker run -d --restart="always" -p 61208-61209:61208-61209 -e TZ="${TZ}" -e GLANCES_OPT="-w" -v /var/run/docker.sock:/var/run/docker.sock:ro -v /run/user/1000/podman/podman.sock:/run/user/1000/podman/podman.sock:ro --pid host nicolargo/glances:latest-full
|
2016-09-20 11:41:08 +03:00
|
|
|
|
2023-05-13 11:47:29 +03:00
|
|
|
For a full list of options, see the Glances `Docker`_ documentation page.
|
|
|
|
|
2014-05-25 20:19:40 +04:00
|
|
|
GNU/Linux
|
|
|
|
---------
|
2013-07-14 02:44:00 +04:00
|
|
|
|
2017-01-21 21:16:15 +03:00
|
|
|
`Glances` is available on many Linux distributions, so you should be
|
|
|
|
able to install it using your favorite package manager. Be aware that
|
2018-09-29 11:55:58 +03:00
|
|
|
when you use this method the operating system `package`_ for `Glances`
|
2023-08-14 11:50:47 +03:00
|
|
|
may not be the latest version and only basics plugins are enabled.
|
2013-04-08 18:16:00 +04:00
|
|
|
|
2022-07-28 11:30:55 +03:00
|
|
|
Note: The Debian package (and all other Debian-based distributions) do
|
|
|
|
not include anymore the JS statics files used by the Web interface
|
2022-10-16 16:30:33 +03:00
|
|
|
(see ``issue2021``). If you want to add it to your Glances installation,
|
|
|
|
follow the instructions: ``issue2021comment``.
|
2022-07-28 11:30:55 +03:00
|
|
|
|
2013-07-14 02:44:00 +04:00
|
|
|
FreeBSD
|
|
|
|
-------
|
|
|
|
|
2014-01-19 21:59:59 +04:00
|
|
|
To install the binary package:
|
2013-04-08 18:16:00 +04:00
|
|
|
|
2014-01-19 21:59:59 +04:00
|
|
|
.. code-block:: console
|
|
|
|
|
2022-03-06 09:05:53 +03:00
|
|
|
# pkg install py38-glances
|
2014-01-19 21:59:59 +04:00
|
|
|
|
2013-07-14 02:44:00 +04:00
|
|
|
To install Glances from ports:
|
|
|
|
|
|
|
|
.. code-block:: console
|
2013-04-08 18:16:00 +04:00
|
|
|
|
2013-07-14 02:44:00 +04:00
|
|
|
# cd /usr/ports/sysutils/py-glances/
|
|
|
|
# make install clean
|
2013-06-05 15:07:17 +04:00
|
|
|
|
2017-01-18 22:00:21 +03:00
|
|
|
macOS
|
|
|
|
-----
|
2013-04-08 18:16:00 +04:00
|
|
|
|
2018-12-28 19:54:33 +03:00
|
|
|
If you do not want to use the glancesautoinstall script, follow this procedure.
|
|
|
|
|
2017-01-18 22:00:21 +03:00
|
|
|
macOS users can install Glances using ``Homebrew`` or ``MacPorts``.
|
2013-04-08 18:16:00 +04:00
|
|
|
|
|
|
|
Homebrew
|
|
|
|
````````
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2018-01-11 23:09:48 +03:00
|
|
|
$ brew install glances
|
2013-04-08 18:16:00 +04:00
|
|
|
|
|
|
|
MacPorts
|
|
|
|
````````
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
$ sudo port install glances
|
|
|
|
|
|
|
|
Windows
|
|
|
|
-------
|
|
|
|
|
2021-08-28 11:23:19 +03:00
|
|
|
Install `Python`_ for Windows (Python 3.4+ ship with pip) and
|
2017-09-21 14:26:43 +03:00
|
|
|
then run the following command:
|
2015-05-06 16:16:10 +03:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
$ pip install glances
|
2013-04-08 18:16:00 +04:00
|
|
|
|
2017-03-15 23:56:58 +03:00
|
|
|
Android
|
|
|
|
-------
|
|
|
|
|
|
|
|
You need a rooted device and the `Termux`_ application (available on the
|
2017-09-21 14:26:43 +03:00
|
|
|
Google Play Store).
|
2017-03-15 23:56:58 +03:00
|
|
|
|
|
|
|
Start Termux on your device and enter:
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
$ apt update
|
|
|
|
$ apt upgrade
|
2020-05-14 01:38:32 +03:00
|
|
|
$ apt install clang python
|
2023-11-27 00:40:36 +03:00
|
|
|
$ pip install fastapi uvicorn orjson jinja2
|
2017-03-15 23:56:58 +03:00
|
|
|
$ pip install glances
|
|
|
|
|
|
|
|
And start Glances:
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
$ glances
|
|
|
|
|
2017-05-16 11:46:06 +03:00
|
|
|
You can also run Glances in server mode (-s or -w) in order to remotely
|
|
|
|
monitor your Android device.
|
|
|
|
|
2013-04-08 18:16:00 +04:00
|
|
|
Source
|
|
|
|
------
|
|
|
|
|
2015-01-04 19:15:26 +03:00
|
|
|
To install Glances from source:
|
2013-04-08 18:16:00 +04:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2015-09-28 22:21:21 +03:00
|
|
|
$ wget https://github.com/nicolargo/glances/archive/vX.Y.tar.gz -O - | tar xz
|
2013-04-08 18:16:00 +04:00
|
|
|
$ cd glances-*
|
|
|
|
# python setup.py install
|
|
|
|
|
2017-01-21 21:16:15 +03:00
|
|
|
*Note*: Python headers are required to install psutil.
|
2013-09-08 00:17:54 +04:00
|
|
|
|
2015-11-24 22:47:51 +03:00
|
|
|
Chef
|
|
|
|
----
|
|
|
|
|
2017-01-21 21:16:15 +03:00
|
|
|
An awesome ``Chef`` cookbook is available to monitor your infrastructure:
|
|
|
|
https://supermarket.chef.io/cookbooks/glances (thanks to Antoine Rouyer)
|
2015-11-24 22:47:51 +03:00
|
|
|
|
2013-04-08 18:16:00 +04:00
|
|
|
Puppet
|
|
|
|
------
|
|
|
|
|
2015-01-04 18:26:55 +03:00
|
|
|
You can install Glances using ``Puppet``: https://github.com/rverchere/puppet-glances
|
2013-04-08 18:16:00 +04:00
|
|
|
|
2018-02-20 23:32:51 +03:00
|
|
|
Ansible
|
|
|
|
-------
|
|
|
|
|
2018-03-15 23:00:57 +03:00
|
|
|
A Glances ``Ansible`` role is available: https://galaxy.ansible.com/zaxos/glances-ansible-role/
|
2018-02-20 23:32:51 +03:00
|
|
|
|
2013-04-08 18:16:00 +04:00
|
|
|
Usage
|
|
|
|
=====
|
|
|
|
|
2014-05-25 20:19:40 +04:00
|
|
|
For the standalone mode, just run:
|
2013-04-08 18:16:00 +04:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2013-05-17 17:55:00 +04:00
|
|
|
$ glances
|
2013-04-08 18:16:00 +04:00
|
|
|
|
2014-05-25 20:19:40 +04:00
|
|
|
For the Web server mode, run:
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
$ glances -w
|
|
|
|
|
2014-06-08 22:44:49 +04:00
|
|
|
and enter the URL ``http://<ip>:61208`` in your favorite web browser.
|
2014-05-25 20:19:40 +04: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 19:15:26 +03:00
|
|
|
You can also detect and display all Glances servers available on your
|
|
|
|
network or defined in the configuration file:
|
2014-11-16 23:31:02 +03:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
2014-11-29 12:17:39 +03:00
|
|
|
$ glances --browser
|
2014-11-16 23:31:02 +03:00
|
|
|
|
2018-12-09 00:08:14 +03:00
|
|
|
You can also display raw stats on stdout:
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
$ glances --stdout cpu.user,mem.used,load
|
|
|
|
cpu.user: 30.7
|
|
|
|
mem.used: 3278204928
|
|
|
|
load: {'cpucore': 4, 'min1': 0.21, 'min5': 0.4, 'min15': 0.27}
|
|
|
|
cpu.user: 3.4
|
|
|
|
mem.used: 3275251712
|
|
|
|
load: {'cpucore': 4, 'min1': 0.19, 'min5': 0.39, 'min15': 0.27}
|
|
|
|
...
|
|
|
|
|
|
|
|
or in a CSV format thanks to the stdout-csv option:
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
$ glances --stdout-csv now,cpu.user,mem.used,load
|
|
|
|
now,cpu.user,mem.used,load.cpucore,load.min1,load.min5,load.min15
|
|
|
|
2018-12-08 22:04:20 CEST,7.3,5948149760,4,1.04,0.99,1.04
|
|
|
|
2018-12-08 22:04:23 CEST,5.4,5949136896,4,1.04,0.99,1.04
|
|
|
|
...
|
|
|
|
|
2022-10-03 16:53:24 +03:00
|
|
|
or in a JSON format thanks to the stdout-json option (attribute not supported in this mode in order to have a real JSON object in output):
|
2022-06-12 11:11:46 +03:00
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
$ glances --stdout-json cpu,mem
|
|
|
|
cpu: {"total": 29.0, "user": 24.7, "nice": 0.0, "system": 3.8, "idle": 71.4, "iowait": 0.0, "irq": 0.0, "softirq": 0.0, "steal": 0.0, "guest": 0.0, "guest_nice": 0.0, "time_since_update": 1, "cpucore": 4, "ctx_switches": 0, "interrupts": 0, "soft_interrupts": 0, "syscalls": 0}
|
|
|
|
mem: {"total": 7837949952, "available": 2919079936, "percent": 62.8, "used": 4918870016, "free": 2919079936, "active": 2841214976, "inactive": 3340550144, "buffers": 546799616, "cached": 3068141568, "shared": 788156416}
|
|
|
|
...
|
|
|
|
|
2015-01-04 19:15:26 +03:00
|
|
|
and RTFM, always.
|
2013-12-15 13:23:06 +04:00
|
|
|
|
2013-04-08 18:16:00 +04:00
|
|
|
Documentation
|
|
|
|
=============
|
|
|
|
|
2016-03-02 15:29:19 +03:00
|
|
|
For complete documentation have a look at the readthedocs_ website.
|
2013-04-08 18:16:00 +04:00
|
|
|
|
2015-01-04 19:15:26 +03:00
|
|
|
If you have any question (after RTFM!), please post it on the official Q&A `forum`_.
|
2014-09-13 11:25:42 +04:00
|
|
|
|
2015-01-10 18:36:53 +03:00
|
|
|
Gateway to other services
|
|
|
|
=========================
|
|
|
|
|
2017-08-15 10:06:26 +03:00
|
|
|
Glances can export stats to: ``CSV`` file, ``JSON`` file, ``InfluxDB``, ``Cassandra``, ``CouchDB``,
|
2017-03-27 12:05:43 +03:00
|
|
|
``OpenTSDB``, ``Prometheus``, ``StatsD``, ``ElasticSearch``, ``RabbitMQ/ActiveMQ``,
|
2021-05-09 19:17:14 +03:00
|
|
|
``ZeroMQ``, ``Kafka``, ``Riemann``, ``Graphite`` and ``RESTful`` server.
|
2015-01-10 18:36:53 +03:00
|
|
|
|
2015-01-31 15:45:48 +03:00
|
|
|
How to contribute ?
|
|
|
|
===================
|
|
|
|
|
2015-09-28 22:21:21 +03:00
|
|
|
If you want to contribute to the Glances project, read this `wiki`_ page.
|
2015-01-31 15:45:48 +03:00
|
|
|
|
2015-04-19 13:45:55 +03:00
|
|
|
There is also a chat dedicated to the Glances developers:
|
2015-01-31 15:45:48 +03: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 18:16:00 +04:00
|
|
|
Author
|
|
|
|
======
|
|
|
|
|
|
|
|
Nicolas Hennion (@nicolargo) <nicolas@nicolargo.com>
|
|
|
|
|
2018-12-31 13:52:47 +03:00
|
|
|
.. image:: https://img.shields.io/twitter/url/https/twitter.com/cloudposse.svg?style=social&label=Follow%20%40nicolargo
|
|
|
|
:target: https://twitter.com/nicolargo
|
|
|
|
|
2013-04-08 18:16:00 +04:00
|
|
|
License
|
|
|
|
=======
|
|
|
|
|
2018-12-31 13:52:47 +03:00
|
|
|
Glances is distributed under the LGPL version 3 license. See ``COPYING`` for more details.
|
2013-04-08 18:16:00 +04:00
|
|
|
|
2015-01-04 18:26:55 +03:00
|
|
|
.. _psutil: https://github.com/giampaolo/psutil
|
2014-09-09 22:54:53 +04:00
|
|
|
.. _glancesautoinstall: https://github.com/nicolargo/glancesautoinstall
|
2015-09-28 22:21:21 +03:00
|
|
|
.. _Python: https://www.python.org/getit/
|
2017-03-15 23:56:58 +03:00
|
|
|
.. _Termux: https://play.google.com/store/apps/details?id=com.termux
|
2016-07-06 17:26:49 +03:00
|
|
|
.. _readthedocs: https://glances.readthedocs.io/
|
2014-09-13 11:25:42 +04:00
|
|
|
.. _forum: https://groups.google.com/forum/?hl=en#!forum/glances-users
|
2015-09-28 22:21:21 +03:00
|
|
|
.. _wiki: https://github.com/nicolargo/glances/wiki/How-to-contribute-to-Glances-%3F
|
2022-12-12 16:24:51 +03:00
|
|
|
.. _package: https://repology.org/project/glances/versions
|
2020-11-21 20:34:32 +03:00
|
|
|
.. _sponsors: https://github.com/sponsors/nicolargo
|
2022-11-01 12:31:41 +03:00
|
|
|
.. _wishlist: https://www.amazon.fr/hz/wishlist/ls/BWAAQKWFR3FI?ref_=wl_share
|
2022-10-16 16:30:33 +03:00
|
|
|
.. _issue2021: https://github.com/nicolargo/glances/issues/2021#issuecomment-1197831157
|
2023-05-08 16:51:57 +03:00
|
|
|
.. _issue2021comment: https://github.com/nicolargo/glances/issues/2021#issuecomment-1197831157
|
2023-05-13 11:47:29 +03:00
|
|
|
.. _Docker: https://github.com/nicolargo/glances/blob/develop/docs/docker.rst
|