2015-10-10 09:25:51 +00:00
|
|
|
.TH glances 1 "October, 2015" "version 2.5.1" "USER COMMANDS"
|
2013-04-08 14:16:00 +00:00
|
|
|
.SH NAME
|
2014-06-09 08:39:39 +00:00
|
|
|
glances \- A cross-platform curses-based system monitoring tool
|
2013-04-08 14:16:00 +00:00
|
|
|
.SH SYNOPSIS
|
|
|
|
.B glances
|
2014-06-09 08:39:39 +00:00
|
|
|
.RI [ OPTIONS ]
|
2013-04-08 14:16:00 +00:00
|
|
|
.SH DESCRIPTION
|
2014-06-09 08:39:39 +00:00
|
|
|
Glances is a free (LGPL) cross-platform curses-based system monitoring tool which
|
|
|
|
aims to present a maximum of information in a minimum of space, ideally to fit in
|
2015-05-13 12:55:00 +00:00
|
|
|
a classical 80x24 terminal or higher to have additional information. It can adapt
|
2014-06-09 08:39:39 +00:00
|
|
|
dynamically the displayed information depending on the terminal size.
|
2013-04-08 14:16:00 +00:00
|
|
|
.PP
|
2014-06-09 08:39:39 +00:00
|
|
|
Glances can also work in client/server mode. Remote monitoring could be done via
|
|
|
|
terminal or web interface.
|
2013-04-08 14:16:00 +00:00
|
|
|
.PP
|
2014-06-09 08:39:39 +00:00
|
|
|
This tool is written in Python and uses the psutil library to fetch the statistical
|
|
|
|
values from key elements, like CPU, load average, memory, network, disks, file
|
|
|
|
systems, processes and so on.
|
2015-11-21 09:53:49 +00:00
|
|
|
.PP
|
|
|
|
The full documentation is available on the ReadTheDocs Web site (http://glances.readthedocs.org/en/latest/)
|
2013-04-08 14:16:00 +00:00
|
|
|
.SH COMMAND-LINE OPTIONS
|
|
|
|
The command-line options are the following:
|
|
|
|
.TP
|
2014-06-09 08:39:39 +00:00
|
|
|
.B \-h, \-\-help
|
2014-11-29 09:17:39 +00:00
|
|
|
show this help message and exit
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
2014-06-09 08:39:39 +00:00
|
|
|
.B \-V, \-\-version
|
|
|
|
show program's version number and exit
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
2014-09-13 13:29:07 +00:00
|
|
|
.B \-d, \-\-debug
|
2015-05-13 12:55:00 +00:00
|
|
|
enable debug mode (log file is /tmp/glances.log)
|
2014-09-13 13:29:07 +00:00
|
|
|
.TP
|
2014-06-09 08:39:39 +00:00
|
|
|
.B \-C CONF_FILE, \-\-config CONF_FILE
|
|
|
|
path to the configuration file
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
2015-08-03 17:01:54 +00:00
|
|
|
.B \-\-disable-quicklook
|
|
|
|
disable quick look module
|
|
|
|
.TP
|
|
|
|
.B \-\-full-quicklook
|
|
|
|
disable all but quick look and load modules
|
|
|
|
.TP
|
|
|
|
.B \-\-disable-cpu
|
|
|
|
disable CPU module
|
|
|
|
.TP
|
|
|
|
.B \-\-disable-mem
|
|
|
|
disable MEM module
|
|
|
|
.TP
|
|
|
|
.B \-\-disable-swap
|
|
|
|
disable SWAP module
|
|
|
|
.TP
|
|
|
|
.B \-\-disable-load
|
|
|
|
disable LOAD module
|
|
|
|
.TP
|
2015-05-13 12:55:00 +00:00
|
|
|
.B \-\-disable-network
|
|
|
|
disable network module
|
2014-09-13 13:29:07 +00:00
|
|
|
.TP
|
2015-05-13 12:55:00 +00:00
|
|
|
.B \-\-disable-ip
|
|
|
|
disable IP module
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
2014-06-09 08:39:39 +00:00
|
|
|
.B \-\-disable-diskio
|
|
|
|
disable disk I/O module
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
2014-06-09 08:39:39 +00:00
|
|
|
.B \-\-disable-fs
|
|
|
|
disable file system module
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
2015-11-21 09:53:49 +00:00
|
|
|
.B \-\-disable-folder
|
|
|
|
disable folders monitoring module
|
|
|
|
.TP
|
2014-06-09 08:39:39 +00:00
|
|
|
.B \-\-disable-sensors
|
|
|
|
disable sensors module
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
2015-05-13 12:55:00 +00:00
|
|
|
.B \-\-disable-hddtemp
|
2015-02-20 21:45:20 +00:00
|
|
|
disable HDDTemp module
|
|
|
|
.TP
|
2015-05-13 12:55:00 +00:00
|
|
|
.B \-\-disable-raid
|
|
|
|
disable RAID module
|
|
|
|
.TP
|
|
|
|
.B \-\-disable-docker
|
|
|
|
disable Docker module
|
2015-02-20 21:45:20 +00:00
|
|
|
.TP
|
2014-10-10 13:27:57 +00:00
|
|
|
.B \-\-disable-left-sidebar
|
2015-05-13 12:55:00 +00:00
|
|
|
disable network, disk I/O, file system and sensors modules
|
2014-10-10 13:27:57 +00:00
|
|
|
.TP
|
2014-06-09 08:39:39 +00:00
|
|
|
.B \-\-disable-process
|
|
|
|
disable process module
|
|
|
|
.TP
|
|
|
|
.B \-\-disable-log
|
|
|
|
disable log module
|
|
|
|
.TP
|
2015-05-13 12:55:00 +00:00
|
|
|
.B \-\-disable-bold
|
|
|
|
disable bold mode in the terminal
|
|
|
|
.TP
|
2014-10-19 14:21:22 +00:00
|
|
|
.B \-\-enable-process-extended
|
|
|
|
enable extended stats on top process
|
|
|
|
.TP
|
2014-11-29 09:17:39 +00:00
|
|
|
.B \-\-enable-history
|
2015-05-13 12:55:00 +00:00
|
|
|
enable the history mode (matplotlib needed)
|
2014-11-29 09:17:39 +00:00
|
|
|
.TP
|
2015-05-13 12:55:00 +00:00
|
|
|
.B \-\-path-history PATH_HISTORY
|
2014-11-29 09:17:39 +00:00
|
|
|
set the export path for graph history
|
|
|
|
.TP
|
2015-05-13 12:55:00 +00:00
|
|
|
.B \-\-export-csv EXPORT_CSV
|
2014-06-09 08:39:39 +00:00
|
|
|
export stats to a CSV file
|
|
|
|
.TP
|
2014-12-30 21:33:54 +00:00
|
|
|
.B \-\-export-influxdb
|
2015-05-13 12:55:00 +00:00
|
|
|
export stats to an InfluxDB server (influxdb needed)
|
2014-12-30 21:33:54 +00:00
|
|
|
.TP
|
2015-08-06 21:07:28 +00:00
|
|
|
.B \-\-export-opentsdb
|
|
|
|
export stats to an OpenTSDB server (potsdb needed)
|
|
|
|
.TP
|
2014-12-30 21:33:54 +00:00
|
|
|
.B \-\-export-statsd
|
2015-05-13 12:55:00 +00:00
|
|
|
export stats to a StatsD server (statsd needed)
|
2014-12-30 21:33:54 +00:00
|
|
|
.TP
|
2015-04-07 18:29:03 +00:00
|
|
|
.B \-\-export-rabbitmq
|
2015-05-13 12:55:00 +00:00
|
|
|
export stats to a RabbitMQ server (pika needed)
|
|
|
|
.TP
|
|
|
|
.B \-c CLIENT, \-\-client CLIENT
|
|
|
|
connect to a Glances server by IPv4/IPv6 address or hostname
|
2015-04-07 18:29:03 +00:00
|
|
|
.TP
|
2014-09-13 13:29:07 +00:00
|
|
|
.B \-s, \-\-server
|
|
|
|
run Glances in server mode
|
|
|
|
.TP
|
2014-11-29 09:17:39 +00:00
|
|
|
.B \-\-browser
|
|
|
|
start the client browser (display list of servers)
|
|
|
|
.TP
|
|
|
|
.B \-\-disable-autodiscover
|
|
|
|
disable autodiscover feature
|
|
|
|
.TP
|
2014-06-09 08:39:39 +00:00
|
|
|
.B \-p PORT, \-\-port PORT
|
|
|
|
define the client/server TCP port [default: 61209]
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
2014-09-13 13:29:07 +00:00
|
|
|
.B \-B BIND_ADDRESS, \-\-bind BIND_ADDRESS
|
|
|
|
bind server to the given IPv4/IPv6 address or hostname
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
2015-05-13 12:55:00 +00:00
|
|
|
.B \-\-password
|
|
|
|
define a client/server password
|
|
|
|
.TP
|
2014-06-09 08:39:39 +00:00
|
|
|
.B \-\-snmp-community SNMP_COMMUNITY
|
|
|
|
SNMP community
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
2014-06-09 08:39:39 +00:00
|
|
|
.B \-\-snmp-port SNMP_PORT
|
|
|
|
SNMP port
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
2014-06-09 08:39:39 +00:00
|
|
|
.B \-\-snmp-version SNMP_VERSION
|
|
|
|
SNMP version (1, 2c or 3)
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
2014-06-09 08:39:39 +00:00
|
|
|
.B \-\-snmp-user SNMP_USER
|
|
|
|
SNMP username (only for SNMPv3)
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
2014-06-09 08:39:39 +00:00
|
|
|
.B \-\-snmp-auth SNMP_AUTH
|
|
|
|
SNMP authentication key (only for SNMPv3)
|
2013-08-14 12:24:14 +00:00
|
|
|
.TP
|
2014-09-13 13:29:07 +00:00
|
|
|
.B \-\-snmp-force
|
2015-05-13 12:55:00 +00:00
|
|
|
force the SNMP mode (do not try Glances server)
|
2014-09-13 13:29:07 +00:00
|
|
|
.TP
|
2014-06-09 08:39:39 +00:00
|
|
|
.B \-t TIME, \-\-time TIME
|
|
|
|
set refresh time in seconds [default: 3 sec]
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
2014-06-09 08:39:39 +00:00
|
|
|
.B \-w, \-\-webserver
|
2015-05-13 12:55:00 +00:00
|
|
|
run Glances in web server mode (bottle needed)
|
2013-08-14 12:24:14 +00:00
|
|
|
.TP
|
2015-03-27 21:03:12 +00:00
|
|
|
.B \-q, \-\-quiet
|
|
|
|
run Glances in quiet mode (nothing is displayed)
|
|
|
|
.TP
|
2015-05-13 12:55:00 +00:00
|
|
|
.B \-f PROCESS_FILTER, \-\-process\-filter PROCESS_FILTER
|
|
|
|
set the process filter pattern (regular expression)
|
|
|
|
.TP
|
|
|
|
.B \-\-process-short-name
|
|
|
|
force short name for processes name
|
|
|
|
.TP
|
2015-07-19 01:59:05 +00:00
|
|
|
.B \-\-disable-irix
|
|
|
|
Task's cpu usage will be divided by the total number of CPUs
|
|
|
|
.TP
|
2015-05-13 12:55:00 +00:00
|
|
|
.B \-\-hide-kernel-threads
|
|
|
|
hide kernel threads in process list
|
|
|
|
.TP
|
|
|
|
.B \-\-tree
|
|
|
|
display processes as a tree
|
|
|
|
.TP
|
|
|
|
.B \-b, \-\-byte
|
|
|
|
display network rate in byte per second [default: bit per second]
|
2015-03-27 21:03:12 +00:00
|
|
|
.TP
|
2015-06-20 12:37:12 +00:00
|
|
|
.B \-\-fahrenheit
|
|
|
|
display temperature in Fahrenheit (default is Celsius)
|
|
|
|
.TP
|
2014-06-09 08:39:39 +00:00
|
|
|
.B \-1, \-\-percpu
|
|
|
|
start Glances in per CPU mode
|
2014-09-13 13:29:07 +00:00
|
|
|
.TP
|
2015-05-13 12:55:00 +00:00
|
|
|
.B \-\-fs-free-space
|
|
|
|
display file system free space instead of used
|
2014-10-19 19:42:26 +00:00
|
|
|
.TP
|
2015-05-13 12:55:00 +00:00
|
|
|
.B \-\-theme-white
|
|
|
|
optimize display colors for white background
|
2013-04-08 14:16:00 +00:00
|
|
|
.SH INTERACTIVE COMMANDS
|
|
|
|
You can use the following keys while in Glances:
|
|
|
|
.TP
|
2014-09-13 13:29:07 +00:00
|
|
|
.B ENTER
|
2014-11-29 09:17:39 +00:00
|
|
|
Set the process filter pattern (as a regular expression)
|
2014-09-13 13:29:07 +00:00
|
|
|
.TP
|
2013-04-08 14:16:00 +00:00
|
|
|
.B a
|
2013-08-14 12:24:14 +00:00
|
|
|
Sort process list automatically
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
|
|
|
.B b
|
2013-08-14 12:24:14 +00:00
|
|
|
Switch between bit/s or Byte/s for network I/O
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
|
|
|
.B c
|
2013-08-14 12:24:14 +00:00
|
|
|
Sort processes by CPU usage
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
|
|
|
.B d
|
2013-08-14 12:24:14 +00:00
|
|
|
Show/hide disk I/O stats
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
2014-11-09 15:56:45 +00:00
|
|
|
.B e
|
2014-09-13 13:29:07 +00:00
|
|
|
Enable/disable top extended stats
|
|
|
|
.TP
|
2015-11-06 17:27:23 +00:00
|
|
|
.B E
|
|
|
|
Erase current process filter
|
|
|
|
.TP
|
2013-04-08 14:16:00 +00:00
|
|
|
.B f
|
|
|
|
Show/hide file system stats
|
2015-05-13 09:55:15 +00:00
|
|
|
.TP
|
2015-05-13 12:55:00 +00:00
|
|
|
.B F
|
|
|
|
Switch between file system used and free space
|
|
|
|
.TP
|
2014-09-13 13:29:07 +00:00
|
|
|
.B g
|
|
|
|
Generate graphs for current history
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
|
|
|
.B h
|
2013-08-14 12:24:14 +00:00
|
|
|
Show/hide the help screen
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
|
|
|
.B i
|
2013-08-14 12:24:14 +00:00
|
|
|
Sort processes by I/O rate
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
|
|
|
.B l
|
|
|
|
Show/hide log messages
|
|
|
|
.TP
|
|
|
|
.B m
|
2013-08-14 12:24:14 +00:00
|
|
|
Sort processes by MEM usage
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
2015-10-22 20:16:29 +00:00
|
|
|
.B M
|
|
|
|
Reset processes summary min/max
|
|
|
|
.TP
|
2013-04-08 14:16:00 +00:00
|
|
|
.B n
|
|
|
|
Show/hide network stats
|
|
|
|
.TP
|
|
|
|
.B p
|
|
|
|
Sort processes by name
|
|
|
|
.TP
|
2013-08-14 12:24:14 +00:00
|
|
|
.B q
|
|
|
|
Quit
|
|
|
|
.TP
|
2014-09-13 13:29:07 +00:00
|
|
|
.B r
|
|
|
|
Reset history
|
|
|
|
.TP
|
2015-10-22 20:16:29 +00:00
|
|
|
.B R
|
|
|
|
Disable/enable RAID plugins
|
|
|
|
.TP
|
2013-04-08 14:16:00 +00:00
|
|
|
.B s
|
2014-06-09 08:39:39 +00:00
|
|
|
Show/hide sensors stats
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
2015-05-13 12:55:00 +00:00
|
|
|
.B t
|
2014-11-29 16:31:20 +00:00
|
|
|
Sort process by CPU times (TIME+)
|
|
|
|
.TP
|
2015-05-13 12:55:00 +00:00
|
|
|
.B T
|
2013-08-14 12:24:14 +00:00
|
|
|
View network I/O as combination
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
|
|
|
.B u
|
2015-04-19 09:49:19 +00:00
|
|
|
Sort processes by USER
|
|
|
|
.TP
|
|
|
|
.B U
|
2013-08-14 12:24:14 +00:00
|
|
|
View cumulative network I/O
|
2013-04-08 14:16:00 +00:00
|
|
|
.TP
|
|
|
|
.B w
|
|
|
|
Delete finished warning log messages
|
|
|
|
.TP
|
|
|
|
.B x
|
|
|
|
Delete finished warning and critical log messages
|
|
|
|
.TP
|
2014-06-09 08:39:39 +00:00
|
|
|
.B z
|
|
|
|
Show/hide processes stats
|
2013-08-14 12:24:14 +00:00
|
|
|
.TP
|
2014-03-19 16:00:00 +00:00
|
|
|
.B z
|
|
|
|
Show/hide processes list (for low CPU consumption)
|
|
|
|
.TP
|
2015-07-19 01:59:05 +00:00
|
|
|
.B 0
|
|
|
|
Task's cpu usage will be divided by the total number of CPUs
|
|
|
|
.TP
|
2013-04-08 14:16:00 +00:00
|
|
|
.B 1
|
|
|
|
Switch between global CPU and per-CPU stats
|
2015-05-13 12:55:00 +00:00
|
|
|
.TP
|
|
|
|
.B 2
|
|
|
|
Enable/disable left sidebar
|
|
|
|
.TP
|
|
|
|
.B 3
|
|
|
|
Enable/disable the quick look module
|
|
|
|
.TP
|
2015-08-03 17:01:54 +00:00
|
|
|
.B 4
|
|
|
|
Enable/disable all but quick look and load module
|
|
|
|
.TP
|
2015-05-13 12:55:00 +00:00
|
|
|
.B /
|
|
|
|
Switch between short name/command line (processes name)
|
2013-04-08 14:16:00 +00:00
|
|
|
.SH EXAMPLES
|
|
|
|
.TP
|
2015-02-20 21:45:20 +00:00
|
|
|
Monitor local machine (standalone mode):
|
|
|
|
.B $ glances
|
|
|
|
.PP
|
|
|
|
Monitor local machine with the Web interface (Web UI):
|
|
|
|
.B $ glances -w
|
|
|
|
.PP
|
|
|
|
Glances web server started on http://0.0.0.0:61208/
|
|
|
|
.PP
|
|
|
|
Monitor local machine and export stats to a CSV file (standalone mode):
|
|
|
|
.B $ glances --export-csv
|
|
|
|
.PP
|
|
|
|
Monitor local machine and export stats to a InfluxDB server with 5s refresh time (standalone mode):
|
|
|
|
.B $ glances -t 5 --export-influxdb
|
|
|
|
.PP
|
2015-04-07 18:29:03 +00:00
|
|
|
Monitor local machine and export stats to a RabbitMQ server with 5s refresh time (standalone mode):
|
|
|
|
.B $ glances -t 5 --export-rabbitmq
|
|
|
|
.PP
|
2015-02-20 21:45:20 +00:00
|
|
|
Start a Glances server (server mode):
|
|
|
|
.B $ glances -s
|
|
|
|
.PP
|
|
|
|
Connect Glances to a Glances server (client mode):
|
|
|
|
.B $ glances -c <ip_server>
|
|
|
|
.PP
|
|
|
|
Connect Glances to a Glances server and export stats to a StatsD server (client mode):
|
|
|
|
.B $ glances -c <ip_server> --export-statsd
|
|
|
|
.PP
|
|
|
|
Start the client browser (browser mode):
|
|
|
|
.B $ glances --browser
|
2013-04-08 14:16:00 +00:00
|
|
|
.PP
|
|
|
|
.SH EXIT STATUS
|
|
|
|
Glances returns a zero exit status if it succeeds to print/grab information.
|
|
|
|
.PP
|
|
|
|
It returns 2 if it fails to parse its options (missing arguments, invalid value, etc).
|
|
|
|
.SH AUTHOR
|
|
|
|
Glances is written by Nicolas Hennion aka Nicolargo (contact@nicolargo.com)
|