summaryrefslogtreecommitdiffstats
path: root/docs/glances.rst
blob: 0d1bde4e42105d2c96b4c78dd13bcc3111f3f5c6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
:orphan:

glances
=======

SYNOPSIS
--------

**glances** [OPTIONS]

DESCRIPTION
-----------

**glances** is a cross-platform curses-based monitoring tool which aims
to present a maximum of information in a minimum of space, ideally to
fit in a classical 80x24 terminal or higher to have additional
information. It can adapt dynamically the displayed information
depending on the terminal size. It can also work in client/server mode.
Remote monitoring could be done via terminal or web interface.

**glances** is written in Python and uses the *psutil* library to get
information from your system.

OPTIONS
-------

.. include:: cmds.rst

CONFIGURATION
-------------

.. include:: config.rst

EXAMPLES
--------

Monitor local machine (standalone mode):

    $ glances

Monitor local machine with the web interface (Web UI), run the following command line:

    $ glances -w

and open a Web browser with the returned URL

Monitor local machine and export stats to a CSV file:

    $ glances --export csv --export-csv-file /tmp/glances.csv

Monitor local machine and export stats to a InfluxDB server with 5s
refresh time (also possible to export to OpenTSDB, Cassandra, Statsd,
ElasticSearch, RabbitMQ and Riemann):

    $ glances -t 5 --export influxdb

It is also possible to export stats to multiple endpoints:

    $ glances -t 5 --export influxdb,statsd,csv

Start a Glances server (server mode):

    $ glances -s

Connect Glances to a Glances server (client mode):

    $ glances -c <ip_server>

Connect to a Glances server and export stats to a StatsD server:

    $ glances -c <ip_server> --export statsd

Start the client browser (browser mode):

    $ glances --browser

AUTHOR
------

Nicolas Hennion aka Nicolargo <contact@nicolargo.com>