summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authornicolargo <nicolas@nicolargo.com>2022-04-10 16:12:34 +0200
committernicolargo <nicolas@nicolargo.com>2022-04-10 16:12:34 +0200
commit0d42dd906852f06596865c055ad39d41b6686888 (patch)
tree2fa27acafe739529b958a99850bb911222918294
parented85bc43edde70e76e3ea960f0f7a87d8aafd959 (diff)
Update release note for Glances 3.2.5
-rw-r--r--NEWS.rst27
-rw-r--r--docs/api.rst443
2 files changed, 261 insertions, 209 deletions
diff --git a/NEWS.rst b/NEWS.rst
index c881dfd2..9d1c36c3 100644
--- a/NEWS.rst
+++ b/NEWS.rst
@@ -6,9 +6,32 @@
Version 3.2.5
===============
-Version under development, see roadmap here:
+Enhancement requests:
+
+ * Add a Accumulated per program function to the Glances process list needs test new feature plugin/ps #2015
+ * Including battery and AC adapter health in Glances enhancement new feature #1049
+ * Display uptime of a docker container enhancement plugin/docker #2004
+ * Add a code formatter enhancement #1964
+
+Bugs corrected:
- https://github.com/nicolargo/glances/milestone/55
+ * Threading.Event.isSet is deprecated in Python 3.10 #2017
+ * Fix code scanning alert - Clear-text logging of sensitive information security #2006
+ * The gpu temperature unit are displayed incorrectly in web ui bug #2002
+ * Doc for 'alert' Restfull/JSON API response documentation #1994
+ * Show the spinning state of a disk documentation #1993
+ * Web server status check endpoint enhancement #1988
+ * --time parameter being ignored for client/server mode bug #1978
+ * Amp with pipe do not work documentation #1976
+ * glances_ip.py plugin relies on low rating / malicious site domain bug security #1975
+ * "N" command freezes/unfreezes the current time instead of show/hide bug #1974
+ * Missing commands in help "h" screen enhancement needs contributor #1973
+ * Grafana dashboards not displayed with influxdb2 enhancement needs contributor #1960
+ * Glances reports different amounts of used memory than free -m or top documentation #1924
+ * Missing: Help command doesn't have info on TCP Connections bug documentation enhancement needs contributor #1675
+ * Docstring convention documentation enhancement #940
+
+Thanks for the bug report and the patch: @RazCrimson, @Karthikeyan Singaravelan, @Moldavite, @ledwards
===============
Version 3.2.4.1
diff --git a/docs/api.rst b/docs/api.rst
index 476b7b72..99483776 100644
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -66,14 +66,14 @@ GET alert
Get plugin stats::
# curl http://localhost:61208/api/3/alert
- [[1649598784.0,
+ [[1649599304.0,
-1,
'WARNING',
'MEM',
- 87.7440430839239,
- 87.7440430839239,
- 87.7440430839239,
- 87.7440430839239,
+ 86.1119576675399,
+ 86.1119576675399,
+ 86.1119576675399,
+ 86.1119576675399,
1,
[],
'',
@@ -93,7 +93,7 @@ Get plugin stats::
'refresh': 3.0,
'regex': True,
'result': None,
- 'timer': 0.17049384117126465},
+ 'timer': 0.30304670333862305},
{'count': 0,
'countmax': 20.0,
'countmin': None,
@@ -102,7 +102,7 @@ Get plugin stats::
'refresh': 3.0,
'regex': True,
'result': None,
- 'timer': 0.17037177085876465}]
+ 'timer': 0.3028125762939453}]
Get a specific field::
@@ -120,7 +120,7 @@ Get a specific item when field matchs the given value::
'refresh': 3.0,
'regex': True,
'result': None,
- 'timer': 0.17049384117126465}]}
+ 'timer': 0.30304670333862305}]}
GET core
--------
@@ -150,19 +150,19 @@ Get plugin stats::
'ctx_switches': 0,
'guest': 0.0,
'guest_nice': 0.0,
- 'idle': 51.4,
+ 'idle': 65.2,
'interrupts': 0,
- 'iowait': 0.0,
+ 'iowait': 1.6,
'irq': 0.0,
- 'nice': 0.9,
+ 'nice': 0.4,
'soft_interrupts': 0,
- 'softirq': 0.2,
+ 'softirq': 2.8,
'steal': 0.0,
'syscalls': 0,
- 'system': 14.2,
+ 'system': 8.7,
'time_since_update': 1,
- 'total': 44.9,
- 'user': 33.3}
+ 'total': 32.7,
+ 'user': 21.3}
Fields descriptions:
@@ -184,7 +184,7 @@ Fields descriptions:
Get a specific field::
# curl http://localhost:61208/api/3/cpu/total
- {'total': 44.9}
+ {'total': 32.7}
GET diskio
----------
@@ -230,13 +230,13 @@ Get plugin stats::
# curl http://localhost:61208/api/3/fs
[{'device_name': '/dev/mapper/ubuntu--gnome--vg-root',
- 'free': 79636021248,
+ 'free': 79634972672,
'fs_type': 'ext4',
'key': 'mnt_point',
'mnt_point': '/',
'percent': 65.5,
'size': 243396149248,
- 'used': 151372673024}]
+ 'used': 151373721600}]
Get a specific field::
@@ -247,13 +247,13 @@ Get a specific item when field matchs the given value::
# curl http://localhost:61208/api/3/fs/mnt_point//
{'/': [{'device_name': '/dev/mapper/ubuntu--gnome--vg-root',
- 'free': 79636021248,
+ 'free': 79634972672,
'fs_type': 'ext4',
'key': 'mnt_point',
'mnt_point': '/',
'percent': 65.5,
'size': 243396149248,
- 'used': 151372673024}]}
+ 'used': 151373721600}]}
GET ip
------
@@ -278,7 +278,7 @@ GET load
Get plugin stats::
# curl http://localhost:61208/api/3/load
- {'cpucore': 4, 'min1': 1.74, 'min15': 1.64, 'min5': 1.41}
+ {'cpucore': 4, 'min1': 0.89, 'min15': 1.54, 'min5': 1.36}
Fields descriptions:
@@ -290,7 +290,7 @@ Fields descriptions:
Get a specific field::
# curl http://localhost:61208/api/3/load/min1
- {'min1': 1.74}
+ {'min1': 0.89}
GET mem
-------
@@ -298,16 +298,16 @@ GET mem
Get plugin stats::
# curl http://localhost:61208/api/3/mem
- {'active': 3487096832,
- 'available': 961970176,
- 'buffers': 188796928,
- 'cached': 1438552064,
- 'free': 961970176,
- 'inactive': 1171030016,
- 'percent': 87.7,
- 'shared': 523972608,
+ {'active': 3203149824,
+ 'available': 1090072576,
+ 'buffers': 96894976,
+ 'cached': 1220718592,
+ 'free': 1090072576,
+ 'inactive': 1164439552,
+ 'percent': 86.1,
+ 'shared': 490676224,
'total': 7849000960,
- 'used': 6887030784}
+ 'used': 6758928384}
Fields descriptions:
@@ -334,13 +334,13 @@ GET memswap
Get plugin stats::
# curl http://localhost:61208/api/3/memswap
- {'free': 7891595264,
- 'percent': 2.4,
- 'sin': 18165760,
- 'sout': 209731584,
+ {'free': 7773106176,
+ 'percent': 3.8,
+ 'sin': 21295104,
+ 'sout': 329736192,
'time_since_update': 1,
'total': 8082419712,
- 'used': 190824448}
+ 'used': 309313536}
Fields descriptions:
@@ -376,9 +376,9 @@ Get plugin stats::
'time_since_update': 1,
'tx': 0},
{'alias': None,
- 'cumulative_cx': 111659,
+ 'cumulative_cx': 139634,
'cumulative_rx': 0,
- 'cumulative_tx': 111659,
+ 'cumulative_tx': 139634,
'cx': 0,
'interface_name': 'vboxnet0',
'is_up': True,
@@ -434,7 +434,7 @@ GET now
Get plugin stats::
# curl http://localhost:61208/api/3/now
- '2022-04-10 15:53:04 CEST'
+ '2022-04-10 16:01:44 CEST'
GET percpu
----------
@@ -445,29 +445,29 @@ Get plugin stats::
[{'cpu_number': 0,
'guest': 0.0,
'guest_nice': 0.0,
- 'idle': 40.0,
- 'iowait': 0.0,
+ 'idle': 83.8,
+ 'iowait': 1.0,
'irq': 0.0,
'key': 'cpu_number',
'nice': 1.0,
'softirq': 0.0,
'steal': 0.0,
- 'system': 8.0,
- 'total': 60.0,
- 'user': 46.0},
+ 'system': 6.7,
+ 'total': 16.2,
+ 'user': 7.6},
{'cpu_number': 1,
'guest': 0.0,
'guest_nice': 0.0,
- 'idle': 55.0,
- 'iowait': 0.0,
+ 'idle': 81.6,
+ 'iowait': 0.9,
'irq': 0.0,
'key': 'cpu_number',
- 'nice': 1.0,
- 'softirq': 0.0,
+ 'nice': 0.0,
+ 'softirq': 7.9,
'steal': 0.0,
- 'system': 6.0,
- 'total': 45.0,
- 'user': 29.0}]
+ 'system': 6.1,
+ 'total': 18.4,
+ 'user': 3.5}]
Get a specific field::
@@ -486,7 +486,7 @@ Get plugin stats::
'port': 0,
'refresh': 30,
'rtt_warning': None,
- 'status': 0.007309,
+ 'status': 0.007046,
'timeout': 3}]
Get a specific field::
@@ -503,7 +503,7 @@ Get a specific item when field matchs the given value::
'port': 0,
'refresh': 30,
'rtt_warning': None,
- 'status': 0.007309,
+ 'status': 0.007046,
'timeout': 3}]}
GET processcount
@@ -512,12 +512,12 @@ GET processcount
Get plugin stats::
# curl http://localhost:61208/api/3/processcount
- {'pid_max': 0, 'running': 1, 'sleeping': 260, 'thread': 1303, 'total': 318}
+ {'pid_max': 0, 'running': 1, 'sleeping': 261, 'thread': 1335, 'total': 330}
Get a specific field::
# curl http://localhost:61208/api/3/processcount/total
- {'total': 318}
+ {'total': 330}
GET processlist
---------------
@@ -533,12 +533,12 @@ Get plugin stats::
'--vrde',
'config'],
'cpu_percent': 0.0,
- 'cpu_times': pcputimes(user=88.06, system=1004.53, children_user=0.0, children_system=0.0, iowait=0.0),
+ 'cpu_times': pcputimes(user=106.02, system=1191.75, children_user=0.0, children_system=0.0, iowait=0.0),
'gids': pgids(real=1000, effective=1000, saved=1000),
'io_counters': [0, 0, 0, 0, 0],
'key': 'pid',
- 'memory_info': pmem(rss=964915200, vms=4202561536, shared=926478336, text=53248, lib=0, data=98004992, dirty=0),
- 'memory_percent': 12.293477920532704,
+ 'memory_info': pmem(rss=963092480, vms=4204658688, shared=924655616, text=53248, lib=0, data=98004992, dirty=0),
+ 'memory_percent': 12.270255602058176,
'name': 'VBoxHeadless',
'nice': 0,
'num_threads': 28,
@@ -547,19 +547,36 @@ Get plugin stats::
'status': 'S',
'time_since_update': 1,
'username': 'nicolargo'},
- {'cmdline': ['/usr/lib/firefox/firefox', '-new-window'],
+ {'cmdline': ['/usr/lib/firefox/firefox',
+ '-contentproc',
+ '-childID',
+ '4',
+ '-isForBrowser',
+ '-prefsLen',
+ '4855',
+ '-prefMapSize',
+ '253021',
+ '-jsInitLen',
+ '278884',
+ '-parentBuildID',
+ '20211215221728',
+ '-appDir',
+ '/usr/lib/firefox/browser',
+ '4964',
+ 'true',
+ 'tab'],
'cpu_percent': 0.0,
- 'cpu_times': pcputimes(user=531.42, system=169.72, children_user=329.51, children_system=45.83, iowait=1.73),
+ 'cpu_times': pcputimes(user=148.98, system=25.6, children_user=0.0, children_system=0.0, iowait=0.03),
'gids': pgids(real=1000, effective=1000, saved=1000),
- 'io_counters': [702185472, 866934784, 0, 0, 0],
+ 'io_counters': [9154560, 0, 0, 0, 0],
'key': 'pid',
- 'memory_info': pmem(rss=469880832, vms=4312092672, shared=119783424, text=643072, lib=0, data=817766400, dirty=0),
- 'memory_percent': 5.986504962792106,
- 'name': 'GeckoMain',
+ 'memory_info': pmem(rss=411983872, vms=3211755520, shared=44138496, text=643072, lib=0, data=648302592, dirty=0),
+ 'memory_percent': 5.248870195067475,
+ 'name': 'WebExtensions',
'nice': 0,
- 'num_threads': 134,
- 'pid': 4964,
- 'ppid': 3777,
+ 'num_threads': 21,
+ 'pid': 5235,
+ 'ppid': 4964,
'status': 'S',
'time_since_update': 1,
'username': 'nicolargo'}]
@@ -568,168 +585,169 @@ Get a specific field::
# curl http://localhost:61208/api/3/processlist/pid
{'pid': [9872,
- 4964,
5235,
- 16062,
+ 4964,
5294,
- 16229,
+ 16062,
5305,
5894,
- 15998,
+ 16229,
4033,
- 17492,
- 16038,
- 15933,
+ 15998,
+ 20039,
15053,
+ 20161,
+ 15933,
+ 16038,
+ 5060,
15966,
- 16111,
- 18604,
- 19240,
+ 20727,
+ 20793,
+ 20685,
5648,
- 17565,
- 5060,
- 16075,
- 16242,
+ 16111,
8850,
2185,
- 15983,
- 3875,
+ 16075,
14178,
- 2410,
- 15938,
- 15937,
- 19494,
- 3789,
+ 21174,
+ 3875,
2233,
+ 15983,
+ 16242,
+ 3789,
3846,
- 4305,
- 1332,
+ 2410,
7066,
- 5595,
5563,
+ 1332,
+ 15938,
+ 15937,
+ 5595,
4119,
+ 14247,
14256,
- 5024,
- 349,
- 4193,
9690,
1160,
- 2380,
- 4094,
3787,
- 4192,
- 4627,
- 1173,
+ 4305,
+ 4094,
+ 4193,
+ 2380,
4187,
1315,
- 1320,
2197,
+ 1320,
+ 4192,
4088,
- 14247,
+ 349,
1,
- 4232,
- 4130,
- 1199,
- 4191,
- 4167,
+ 1173,
1175,
- 4213,
+ 5024,
+ 1199,
3531,
9684,
- 4064,
- 2189,
- 4308,
- 14266,
- 1039,
4062,
+ 4130,
+ 2386,
10484,
- 4589,
+ 4627,
+ 4191,
+ 14266,
+ 2189,
+ 4232,
4019,
- 14265,
4194,
- 4188,
+ 14265,
+ 4213,
+ 4589,
+ 1039,
+ 4167,
+ 15940,
+ 4308,
1584,
+ 4188,
+ 4105,
4198,
- 3777,
- 2386,
+ 4064,
3762,
1326,
- 15940,
+ 3777,
3824,
- 4105,
+ 1196,
1365,
4057,
- 1196,
+ 3831,
1142,
3900,
- 16135,
- 3831,
- 3813,
- 4203,
- 4276,
- 1195,
1158,
- 3855,
+ 3813,
1201,
- 8860,
+ 4276,
+ 4203,
9177,
- 3797,
+ 16135,
+ 8860,
+ 1195,
2384,
+ 3797,
4190,
4209,
- 383,
- 4179,
1166,
- 4068,
- 1192,
+ 3855,
3872,
- 4301,
- 4061,
- 4600,
+ 2385,
+ 1192,
+ 4068,
4079,
4229,
- 3988,
- 2385,
4102,
- 4269,
- 1186,
+ 4179,
+ 3988,
4186,
+ 4061,
3791,
- 3998,
- 3817,
- 3861,
- 3842,
+ 4600,
3536,
- 1040,
+ 1186,
+ 3861,
+ 3998,
+ 4301,
4197,
+ 3817,
3836,
+ 4269,
4195,
+ 3842,
+ 1040,
+ 383,
4200,
1182,
+ 1168,
1202,
- 16161,
1150,
- 1168,
- 1151,
4013,
- 4083,
- 1380,
4003,
+ 4083,
+ 1151,
1038,
1155,
1446,
- 19463,
+ 16161,
+ 21157,
1230,
- 3778,
+ 1380,
4546,
1143,
- 19493,
+ 3778,
2062,
- 2201,
+ 21173,
2112,
2218,
- 2203,
+ 2201,
1235,
+ 2203,
1015,
377,
1153,
@@ -883,8 +901,19 @@ Get a specific field::
16158,
16256,
16973,
- 18159,
- 19193]}
+ 19931,
+ 19932,
+ 19999,
+ 20344,
+ 20357,
+ 20572,
+ 20631,
+ 20632,
+ 20724,
+ 20826,
+ 20850,
+ 20851,
+ 21047]}
Get a specific item when field matchs the given value::
@@ -897,18 +926,18 @@ Get a specific item when field matchs the given value::
'--vrde',
'config'],
'cpu_percent': 0.0,
- 'cpu_times': [88.06, 1004.53, 0.0, 0.0, 0.0],
+ 'cpu_times': [106.02, 1191.75, 0.0, 0.0, 0.0],
'gids': [1000, 1000, 1000],
'io_counters': [0, 0, 0, 0, 0],
'key': 'pid',
- 'memory_info': [964915200,
- 4202561536,
- 926478336,
+ 'memory_info': [963092480,
+ 4204658688,
+ 924655616,
53248,
0,
98004992,
0],
- 'memory_percent': 12.293477920532704,
+ 'memory_percent': 12.270255602058176,
'name': 'VBoxHeadless',
'nice': 0,
'num_threads': 28,
@@ -932,69 +961,69 @@ GET quicklook
Get plugin stats::
# curl http://localhost:61208/api/3/quicklook
- {'cpu': 44.9,
+ {'cpu': 32.7,
'cpu_hz': 3000000000.0,
- 'cpu_hz_current': 2472500.0,
+ 'cpu_hz_current': 2071000.0000000002,
'cpu_name': 'Intel(R) Core(TM) i7-4500U CPU @ 1.80GHz',
- 'mem': 87.7,
+ 'mem': 86.1,
'percpu': [{'cpu_number': 0,
'guest': 0.0,
'guest_nice': 0.0,
- 'idle': 40.0,
- 'iowait': 0.0,
+ 'idle': 83.8,
+ 'iowait': 1.0,
'irq': 0.0,
'key': 'cpu_number',
'nice': 1.0,
'softirq': 0.0,
'steal': 0.0,
- 'system': 8.0,
- 'total': 60.0,
- 'user': 46.0},
+ 'system': 6.7,
+ 'total': 16.2,
+ 'user': 7.6},
{'cpu_number': 1,
'guest': 0.0,
'guest_nice': 0.0,
- 'idle': 55.0,
- 'iowait': 0.0,
+ 'idle': 81.6,
+ 'iowait': 0.9,
'irq': 0.0,
'key': 'cpu_number',
- 'nice': 1.0,
- 'softirq': 0.0,
+ 'nice': 0.0,
+ 'softirq': 7.9,
'steal': 0.0,
- 'system': 6.0,
- 'total': 45.0,
- 'user': 29.0},
+ 'system': 6.1,
+ 'total': 18.4,
+ 'user': 3.5},
{'cpu_number': 2,
'guest': 0.0,
'guest_nice': 0.0,
- 'idle': 70.0,
- 'iowait': 0.0,
+ 'idle': 51.4,
+ 'iowait': 6.3,
'irq': 0.0,
'key': 'cpu_number',
- 'nice': 1.0,
- 'softirq': 0.0,
+ 'nice': 0.0,
+ 'softirq': 1.8,
'steal': 0.0,
- 'system': 8.0,
- 'total': 30.0,
- 'user': 13.0},
+ 'system': 11.7,
+ 'total': 48.6,
+ 'user': 28.8},
{'cpu_number': 3,
'guest': 0.0,
'guest_nice': 0.0,
- 'idle': 39.0,
+ 'idle': 44.0,
'iowait': 0.0,
'irq': 0.0,
'key': 'cpu_number',
'nice': 0.0,
- 'softirq': 1.0,
+ 'softirq': 0.9,
'steal': 0.0,
- 'system': 19.0,
- 'total': 61.0,
- 'user': 33.0}],
- 'swap': 2.4}
+ 'system': 5.5,
+ 'total': 56.0,
+ 'user': 49.5}],
+ 'swap': 3.8}
Get a specific field::
# curl http://localhost:61208/api/3/quicklook/cpu
- {'cpu': 44.9}
+ {'cpu': 32.7}
GET sensors
-----------
@@ -1065,7 +1094,7 @@ GET uptime
Get plugin stats::
# curl http://localhost:61208/api/3/uptime
- {'seconds': 198010}
+ {'seconds': 198530}
GET all stats
-------------
@@ -1081,33 +1110,33 @@ GET stats history
History of a plugin::
# curl http://localhost:61208/api/3/cpu/history
- {'system': [['2022-04-10T15:53:04.470357', 14.2],
- ['2022-04-10T15:53:05.515631', 14.2],
- ['2022-04-10T15:53:06.601141', 11.0]],
- 'user': [['2022-04-10T15:53:04.470351', 33.3],
- ['2022-04-10T15:53:05.515624', 33.3],
- ['2022-04-10T15:53:06.601136', 13.3]]}
+ {'system': [['2022-04-10T16:01:44.535906', 8.7],
+ ['2022-04-10T16:01:45.577607', 8.7],
+ ['2022-04-10T16:01:46.684425', 11.6]],
+ 'user': [['2022-04-10T16:01:44.535900', 21.3],
+ ['2022-04-10T16:01:45.577603', 21.3],
+ ['2022-04-10T16:01:46.684420', 5.3]]}
Limit history to last 2 values::
# curl http://localhost:61208/api/3/cpu/history/2
- {'system': [['2022-04-10T15:53:05.515631', 14.2],
- ['2022-04-10T15:53:06.601141', 11.0]],
- 'user': [['2022-04-10T15:53:05.515624', 33.3],
- ['2022-04-10T15:53:06.601136', 13.3]]}
+ {'system': [['2022-04-10T16:01:45.577607', 8.7],
+ ['2022-04-10T16:01:46.684425', 11.6]],
+ 'user': [['2022-04-10T16:01:45.577603', 21.3],
+ ['2022-04-10T16:01:46.684420', 5.3]]}
History for a specific field::
# curl http://localhost:61208/api/3/cpu/system/history
- {'system': [['2022-04-10T15:53:04.470357', 14.2],
- ['2022-04-10T15:53:05.515631', 14.2],
- ['2022-04-10T15:53:06.601141', 11.0]]}
+ {'system': [['2022-04-10T16:01:44.535906', 8.7],
+ ['2022-04-10T16:01:45.577607', 8.7],
+ ['2022-04-10T16:01:46.684425', 11.6]]}
Limit history for a specific field to last 2 values::
# curl http://localhost:61208/api/3/cpu/system/history
- {'system': [['2022-04-10T15:53:05.515631', 14.2],
- ['2022-04-10T15:53:06.601141', 11.0]]}
+ {'system': [['2022-04-10T16:01:45.577607', 8.7],
+ ['2022-04-10T16:01:46.684425', 11.6]]}
GET limits (used for thresholds)
--------------------------------