NAME¶
glances - A cross-platform curses-based system monitoring tool
SYNOPSIS¶
glances [
OPTIONS]
DESCRIPTION¶
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 a classical 80x24 terminal or higher to have additionnal
information. It can adapt dynamically the displayed information depending on
the terminal size.
Glances can also work in client/server mode. Remote monitoring could be done via
terminal or web interface.
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.
COMMAND-LINE OPTIONS¶
The command-line options are the following:
- -h, --help
- display the help and exit
- -V, --version
- show program's version number and exit
- -d, --debug
- Enable debug mode (log file is /tmp/glances.log)
- -b, --byte
- display network rate in byte per second [default: bit per second]
- -C CONF_FILE, --config CONF_FILE
- path to the configuration file
- --enable-history
- enable the history mode
- --disable-bold
- disable bold mode in the terminal
- --disable-diskio
- disable disk I/O module
- --disable-fs
- disable file system module
- --disable-network
- disable network module
- --disable-network
- disable network module
- --disable-sensors
- disable sensors module
- --disable-process
- disable process module
- --disable-process-extended
- disable extended stats on top process
- --disable-log
- disable log module
- --output-csv OUTPUT_CSV
- export stats to a CSV file
- -s, --server
- run Glances in server mode
- -c CLIENT, --client CLIENT
- connect to a Glances server by IPv4/IPv6 address or hostname
- -p PORT, --port PORT
- define the client/server TCP port [default: 61209]
- --password
- define a client/server password from the prompt or file
- -B BIND_ADDRESS, --bind BIND_ADDRESS
- bind server to the given IPv4/IPv6 address or hostname
- --snmp-community SNMP_COMMUNITY
- SNMP community
- --snmp-port SNMP_PORT
- SNMP port
- --snmp-version SNMP_VERSION
- SNMP version (1, 2c or 3)
- --snmp-user SNMP_USER
- SNMP username (only for SNMPv3)
- --snmp-auth SNMP_AUTH
- SNMP authentication key (only for SNMPv3)
- --snmp-force
- Force the SNMP mode (do not try Glances server)
- -t TIME, --time TIME
- set refresh time in seconds [default: 3 sec]
- -w, --webserver
- run Glances in Web server mode
- -1, --percpu
- start Glances in per CPU mode
- -1, --process-short-name
- Force short name for processes name
- -1, --theme-white
- Optimize display for white background
INTERACTIVE COMMANDS¶
You can use the following keys while in Glances:
- ENTER
- Set the process filter patern (as a regular expression)
- a
- Sort process list automatically
- b
- Switch between bit/s or Byte/s for network I/O
- c
- Sort processes by CPU usage
- d
- Show/hide disk I/O stats
- e
- Enable/disable top extended stats
- f
- Show/hide file system stats g Generate graphs for current
history
- h
- Show/hide the help screen
- i
- Sort processes by I/O rate
- l
- Show/hide log messages
- m
- Sort processes by MEM usage
- n
- Show/hide network stats
- p
- Sort processes by name
- q
- Quit
- r
- Reset history
- s
- Show/hide sensors stats
- t
- View network I/O as combination
- u
- View cumulative network I/O
- w
- Delete finished warning log messages
- x
- Delete finished warning and critical log messages
- z
- Show/hide processes stats
- z
- Show/hide processes list (for low CPU consumption)
- 1
- Switch between global CPU and per-CPU stats
EXAMPLES¶
- Refresh information every 5 seconds:
- glances -t 5
EXIT STATUS¶
Glances returns a zero exit status if it succeeds to print/grab information.
It returns 2 if it fails to parse its options (missing arguments, invalid value,
etc).
AUTHOR¶
Glances is written by Nicolas Hennion aka Nicolargo
(contact@nicolargo.com)