Glances 3.0 Release Note
- Support fo Python 3.3 as been removed (yes Glances is still compatible with Python 2.7)
- Support for PsUtil < 5.3 as been removed
- XML/RPC API have changed between Glances 2 and Glances 3. It is not possible to use a Glances 2.x client with a Glances 3.x server and conversely
- Restful API upgraded to version 3 (default entry point: http://localhost:61208/api/3)
A new stat is available for all displayed processes: thread count.
It is now possible to run the Restful API without the Web User Interface (UI) using the --disable-webui option.
Web UI and API (default Web server mode):
# glances -w
Glances Web User Interface started on http://0.0.0.0:61208/
Web API without UI:
# glances -w --disable-webui
Glances Restful API Server started on http://0.0.0.0:61208/api/3/
The export module has been completely refactor and the Matplotlib graph generation lib replaced by Pygal. You can generate dynamic graphs (SVG format) in a target folder. The generation starts every time the 'g' hotkey is pressed in the CLI interface or every 'generate_every' seconds (see the configuration key in the glances.conf file).
Example og graph section in the glances.conf file:
[graph]
# Configuration for the --export graph option
# Set the path where the graph (.svg files) will be created
# Can be overwrite by the --graph-path command line option
path=/tmp
# It is possible to generate the graphs automatically by setting the
# generate_every to a non zero value corresponding to the seconds between
# two generation. Set it to 0 to disable graph auto generation.
generate_every=60
# See followings configuration keys definitions in the Pygal lib documentation
# http://pygal.org/en/stable/documentation/index.html
width=800
height=600
style=DarkStyle
and run Glances with:
$ glances --export graph
Example of output (load graph)
Note: SVG files can be openned in every modern Web Browser.
A new configuration key has been added in the Glances configuration file (default value is False).
Set it to True to display all the containers:
[docker]
# By default, Glances only display running containers
# Set the following key to True to display all containers
all=True
Result in the curses interface:
Add the possibility to use system call in the Glances configuration file sections.
Note: the system call is evaluate when the Glances configuration file is read.
Example to add a tag with the hostname in an InfluxDB export section:
[influxdb]
prefix=`hostname`
tags=foo:bar,spam:eggs,system:`uname -a`
In Glances < 3.0, if you want to disable one or more plugin you should enter the following command line:
# glances --disable-network --disable-load
With Glances 3.0 and higher it is replaced by:
# glances --disable-plugin network,load
The new syntax will bring some dynamic function for the developer when a new plugin is added.
Same kind of call should be done for the export module (--export).
A new --modules-list option should be available to display the plugins and exports module:
# glances --modules-list
Plugins list: load, docker, help, ip, memswap, processlist, cloud, uptime, network, percpu, irq, system, diskio, gpu, folders, core, fs, raid, mem, alert, psutilversion, hddtemp, sensors, now, quicklook, wifi, cpu, processcount, amps, batpercent, ports
Exporters list: statsd, riemann, couchdb, prometheus, rabbitmq, kafka, json, elasticsearch, influxdb, opentsdb, zeromq, csv, restful, cassandra
A new light mode is available in the curse interface.
# glances --light
Implement configuration threshold for 'nice' values. Define color levels using a comma separated list of 'nice' values for nice_careful, nice_warning and/or nice_critical. The list may contain negative, positive or zero values.
[processlist]
# Nice priorities range from -20 to 19.
# Configure nice levels using a comma separated list.
#
# Nice: Example 1, non-zero is warning (default behavior)
nice_warning=-20,-19,-18,-17,-16,-15,-14,-13,-12,-11,-10,-9,-8,-7,-6,-5,-4,-3,-2,-1,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19
#
# Nice: Example 2, low priority processes escalate from careful to critical
#nice_careful=1,2,3,4,5,6,7,8,9
#nice_warning=10,11,12,13,14
#nice_critical=15,16,17,18,19
A new output module is available in order to display RAWJson stats to standard output (stdout).
Examples:
# glances --stdout cpu
cpu: {'softirq': 0.0, 'iowait': 0.0, 'interrupts': 852, 'system': 0.9, 'guest': 0.0, 'soft_interrupts': 1091, 'time_since_update': 3.0178308486938477, 'idle': 96.0, 'user': 2.8, 'guest_nice': 0.0, 'irq': 0.0, 'cpucore': 4, 'syscalls': 0, 'total': 6.4, 'steal': 0.0, 'ctx_switches': 2613, 'nice': 0.3}
cpu: {'softirq': 0.0, 'iowait': 0.1, 'interrupts': 761, 'system': 1.2, 'guest': 0.0, 'soft_interrupts': 1078, 'time_since_update': 3.00667405128479, 'idle': 96.2, 'user': 2.3, 'guest_nice': 0.0, 'irq': 0.0, 'cpucore': 4, 'syscalls': 0, 'total': 3.7, 'steal': 0.0, 'ctx_switches': 3753, 'nice': 0.3}
cpu: {'softirq': 0.0, 'iowait': 0.1, 'interrupts': 1000, 'system': 1.6, 'guest': 0.0, 'soft_interrupts': 1218, 'time_since_update': 2.9971659183502197, 'idle': 95.2, 'user': 2.8, 'guest_nice': 0.0, 'irq': 0.0, 'cpucore': 4, 'syscalls': 0, 'total': 4.8, 'steal': 0.0, 'ctx_switches': 4033, 'nice': 0.4}
# glances --stdout cpu.user
cpu.user: 2.8
cpu.user: 4.3
cpu.user: 3.3
# glances --stdout cpu.user,mem
mem: {'available': 4057534464, 'used': 3814420480, 'cached': 3555233792, 'percent': 48.5, 'free': 4057534464, 'inactive': 1829580800, 'active': 4756611072, 'shared': 396623872, 'total': 7871954944, 'buffers': 618676224}
cpu.user: 3.0
mem: {'available': 4057026560, 'used': 3814928384, 'cached': 3555233792, 'percent': 48.5, 'free': 4057026560, 'inactive': 1829576704, 'active': 4756856832, 'shared': 396623872, 'total': 7871954944, 'buffers': 618684416}
cpu.user: 2.9
mem: {'available': 4055138304, 'used': 3816816640, 'cached': 3555241984, 'percent': 48.5, 'free': 4055138304, 'inactive': 1829580800, 'active': 4758806528, 'shared': 396623872, 'total': 7871954944, 'buffers': 618684416}
Note: It will display one line per stat.
- Make the left side bar width dynamic in the Curse UI #1177
- Add deflate compression support to the RestAPI (and support in the WebUI) #1182
- Add context switches bottleneck identification #1212
- Refactor the InfluxDB exporter (API is now stable) #1166
- Add a code of conduct for Glances project's participants #1211
- Take advantage of the psutil issue #1025 (Add process_iter(attrs, ad_value)) #1105
- Display debug message if dep lib is not found #1224