Command Reference¶
Command-Line Options¶
-
-h
,
--help
¶
show this help message and exit
-
-V
,
--version
¶
show program’s version number and exit
-
-d
,
--debug
¶
enable debug mode
-
-C
CONF_FILE
,
--config
CONF_FILE
¶ path to the configuration file
-
--modules-list
¶
display modules (plugins & exports) list and exit
-
--disable-plugin
PLUGIN
¶ disable PLUGIN (comma separated list)
-
--enable-plugin
PLUGIN
¶ enable PLUGIN (comma separated list)
-
--stdout
PLUGINS_STATS
¶ display stats to stdout (comma separated list of plugins/plugins.attribute)
-
--export
EXPORT
¶ enable EXPORT module (comma separated list)
-
--export-csv-file
EXPORT_CSV_FILE
¶ file path for CSV exporter
-
--export-json-file
EXPORT_JSON_FILE
¶ file path for JSON exporter
-
--disable-process
¶
disable process module (reduce Glances CPU consumption)
-
--disable-webui
¶
disable the Web UI (only the RESTful API will respond)
-
--light
,
--enable-light
¶
light mode for Curses UI (disable all but top menu)
-
-0
,
--disable-irix
¶
task’s CPU usage will be divided by the total number of CPUs
-
-1
,
--percpu
¶
start Glances in per CPU mode
-
-2
,
--disable-left-sidebar
¶
disable network, disk I/O, FS and sensors modules
-
-3
,
--disable-quicklook
¶
disable quick look module
-
-4
,
--full-quicklook
¶
disable all but quick look and load
-
-5
,
--disable-top
¶
disable top menu (QuickLook, CPU, MEM, SWAP and LOAD)
-
-6
,
--meangpu
¶
start Glances in mean GPU mode
-
--enable-history
¶
enable the history mode
-
--disable-bold
¶
disable bold mode in the terminal
-
--disable-bg
¶
disable background colors in the terminal
-
--enable-process-extended
¶
enable extended stats on top process
-
-c
CLIENT
,
--client
CLIENT
¶ connect to a Glances server by IPv4/IPv6 address, hostname or hostname:port
-
-s
,
--server
¶
run Glances in server mode
-
--browser
¶
start the client browser (list of servers)
-
--disable-autodiscover
¶
disable autodiscover feature
-
-p
PORT
,
--port
PORT
¶ define the client/server TCP port [default: 61209]
-
-B
BIND_ADDRESS
,
--bind
BIND_ADDRESS
¶ bind server to the given IPv4/IPv6 address or hostname
-
--username
¶
define a client/server username
-
--password
¶
define a client/server password
-
--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 SNMP mode
-
-t
TIME
,
--time
TIME
¶ set refresh time in seconds [default: 3 sec]
-
-w
,
--webserver
¶
run Glances in web server mode (bottle lib needed)
-
--cached-time
CACHED_TIME
¶ set the server cache time [default: 1 sec]
-
open-web-browser
¶
try to open the Web UI in the default Web browser
-
-q
,
--quiet
¶
do not display the curses interface
-
-f
PROCESS_FILTER
,
--process-filter
PROCESS_FILTER
¶ set the process filter pattern (regular expression)
-
--process-short-name
¶
force short name for processes name
-
--hide-kernel-threads
¶
hide kernel threads in process list (not available on Windows)
-
-b
,
--byte
¶
display network rate in byte per second
-
--diskio-show-ramfs
¶
show RAM FS in the DiskIO plugin
-
--diskio-iops
¶
show I/O per second in the DiskIO plugin
-
--fahrenheit
¶
display temperature in Fahrenheit (default is Celsius)
-
--fs-free-space
¶
display FS free space instead of used
-
--theme-white
¶
optimize display colors for white background
-
--disable-check-update
¶
disable online Glances version ckeck
Interactive Commands¶
The following commands (key pressed) are supported while in Glances:
ENTER
Set the process filter
Note
On macOS please use
CTRL-H
to delete filter.Filter is a regular expression pattern:
gnome
: matches all processes starting with thegnome
string.*gnome.*
: matches all processes containing thegnome
string
a
Sort process list automatically
If CPU
>70%
, sort processes by CPU usageIf MEM
>70%
, sort processes by MEM usageIf CPU iowait
>60%
, sort processes by I/O read and write
A
Enable/disable Application Monitoring Process
b
Switch between bit/s or Byte/s for network I/O
B
View disk I/O counters per second
c
Sort processes by CPU usage
C
Enable/disable cloud stats
d
Show/hide disk I/O stats
D
Enable/disable Docker stats
e
Enable/disable top extended stats
E
Erase current process filter
f
Show/hide file system and folder monitoring stats
F
Switch between file system used and free space
g
Generate graphs for current history
G
Enable/disable GPU stats
h
Show/hide the help screen
i
Sort processes by I/O rate
I
Show/hide IP module
k
Kill selected process
K
Show/hide TCP connections
l
Show/hide log messages
m
Sort processes by MEM usage
M
Reset processes summary min/max
n
Show/hide network stats
N
Show/hide current time
p
Sort processes by name
P
Enable/Disable ports stats
q|ESC|CTRL-C
Quit the current Glances session
Q
Show/hide IRQ module
r
Reset history
R
Show/hide RAID plugin
s
Show/hide sensors stats
S
Enable/disable spark lines
t
Sort process by CPU times (TIME+)
T
View network I/O as combination
u
Sort processes by USER
U
View cumulative network I/O
w
Delete finished warning log messages
W
Show/hide Wifi module
x
Delete finished warning and critical log messages
z
Show/hide processes stats
0
Enable/disable Irix/Solaris mode
Task’s CPU usage will be divided by the total number of CPUs
1
Switch between global CPU and per-CPU stats
2
Enable/disable left sidebar
3
Enable/disable the quick look module
4
Enable/disable all but quick look and load module
5
Enable/disable top menu (QuickLook, CPU, MEM, SWAP and LOAD)
6
Enable/disable mean GPU mode
9
Switch UI theme between black and white
/
Switch between process command line or command name
F5
Refresh stats in curses user interface
LEFT
Navigation leff through process sort
RIGHT
Navigation right through process sort
UP
Up in the processes list
DOWN
Down in the processes list
In the Glances client browser (accessible through the --browser
command line argument):
ENTER
Run the selected server
UP
Up in the servers list
DOWN
Down in the servers list
q|ESC
Quit Glances