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
              show this help message and exit

       -V, --version
              show program's version number and exit

       -d, --debug
              Enable debug mode (log file is /tmp/glances.log)

       -C CONF_FILE, --config CONF_FILE
              path to the configuration file

       -b, --byte
              display network rate in byte per second [default: bit per second]

       --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-sensors
              disable sensors module

       --disable-left-sidebar
              disable network, disk IO, FS and sensors modules

       --disable-process
              disable process module

       --disable-log
              disable log module

       --enable-process-extended
              enable extended stats on top process

       --enable-history
              enable the history mode

       B --path-history PATH_HISTORY
              set the export path for graph history

       --export-csv CSV_FILE
              export stats to a CSV file

       --export-influxdb
              export stats to an InfluxDB server

       --export-statsd
              export stats to a Statsd server

       -s, --server
              run Glances in server mode

       --browser
              start the client browser (display list of servers)

       --disable-autodiscover
              disable autodiscover feature

       -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, --fs-free-space
              Display FS free space instead of used

       -1, --theme-white
              Optimize display for white background

INTERACTIVE COMMANDS

       You can use the following keys while in Glances:

       ENTER  Set the process filter pattern (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      Sort process by CPU times (TIME+)

       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)