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 usage - If MEM
>70%
, sort processes by MEM usage - If CPU iowait
>60%
, sort processes by I/O read and write
- If CPU
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
+
- Increase selected process nice level / Lower the priority (need right) - Only in standalone mode.
-
- Decrease selected process nice level / Higher the priority (need right) - Only in standalone mode.
k
- Kill selected process (need right) - Only in standalone mode.
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