mirror
/
glances
mirror of https://github.com/nicolargo/glances.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

version 4.2.0

This commit is contained in:
nicolargo 2024-10-20 18:02:15 +02:00
parent 7d44a2f554
commit a8608f17d6
2 changed files with 265 additions and 204 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

65
NEWS.rst
View File

@ -2,13 +2,74 @@
Glances ChangeLog Glances ChangeLog
============================================================================== ==============================================================================
===============
Version 4.2.0
===============
Enhancements:
* [WEBUI] Migration to bootstrap 5 #2914
* New Ubuntu Multipass VM orchestartor plugin #2252
* Show only active Disk I/O (and network interface) #2929
* Make the central client UI configurable (example: GPU status) #1289
* Please make py-orjson optional: it pulls in dependency on Rust #2930
* Use defusedxml lib #2979
* Do not display Unknown information in the cloud plugin #2485
* Filter Docker containers - #2962
* Add retain to availability topic in MQTT plugin #2974
* Make fields labelled in Green easier to see #2882
Bug corrected:
* In TUI, when processes are filtered, column are not aligned #2980
* Can't kill process. Standalone, Ubuntu 24.04 #2942
* Internal Server Error #2943
* Timezone for warning/errors is incorrect #2901
* Error while initializing the containers plugin ('type' object is not subscriptable) #2922
* url_prefix do not work in Glances < 4.2.0 - Correct issue with mount #2912
* Raid plugin breaks with inactive raid0 arrays #2908
* Crash when terminal is resized #2872
* Check if server name is not null in the Glances browser - Related to #2861
* Only display VMs with a running status (in the Vms plugin)
Continuous integration and documentation:
* Incomplete pipx install to allow webui + containers #2955
* Stick FastAPI version to 0.82.0 or higher (latest is better) - Related to #2926
* api/4/vms returns a dict, thus breaking make test-restful #2918
* Migration to Alpine 3.20 and Python 3.12 for Alpine Docker
Improve code quality (thanks to Ariel Otilibili !):
* Merge pull request #2959 from ariel-anieli/plugins-port-alerts
* Merge pull request #2957 from ariel-anieli/plugin-port-msg
* Merge pull request #2954 from ariel-anieli/makefile
* Merge pull request #2941 from ariel-anieli/refactor-alert
* Merge pull request #2950 from ariel-anieli/revert-commit-01823df9
* Merge pull request #2932 from ariel-anieli/refactorize-display-plugin
* Merge pull request #2924 from ariel-anieli/makefile
* Merge pull request #2919 from ariel-anieli/refactor-plugin-model-msg-curse
* Merge pull request #2917 from ariel-anieli/makefile
* Merge pull request #2915 from ariel-anieli/refactor-process-thread
* Merge pull request #2913 from ariel-anieli/makefile
* Merge pull request #2910 from ariel-anieli/makefile
* Merge pull request #2900 from ariel-anieli/issue-2801-catch-key
* Merge pull request #2907 from ariel-anieli/refactorize-makefile
* Merge pull request #2891 from ariel-anieli/issue-2801-plugin-msg-curse
* Merge pull request #2884 from ariel-anieli/issue-2801-plugin-update
Thanks to all contributors and bug reporters !
Special thanks to:
* Ariel Otilibili, he has made an incredible work to improve Glances code quality !
* RazCrimson, thanks for all your contributions !
* Bharath Vignesh J K
* Neveda
* ey-jo
=============== ===============
Version 4.1.2 Version 4.1.2
=============== ===============
Bug corrected: Bug corrected:
* AttributeError: 'CpuPercent' object has no attribute 'cpu_percent' #2859 * AttributeError: 'CpuPercent' object has no attribute 'cpu_percent' #2859
=============== ===============
Version 4.1.1 Version 4.1.1
@ -16,7 +77,7 @@ Version 4.1.1
Bug corrected: Bug corrected:
* Sensors data is not exported using InfluxDB2 exporter #2856 * Sensors data is not exported using InfluxDB2 exporter #2856
=============== ===============
Version 4.1.0 Version 4.1.0

404
docs/api.rst
View File

@ -142,7 +142,7 @@ Get plugin stats::
"refresh": 3.0, "refresh": 3.0,
"regex": True, "regex": True,
"result": None, "result": None,
"timer": 0.6462993621826172}, "timer": 0.6609578132629395},
{"count": 0, {"count": 0,
"countmax": 20.0, "countmax": 20.0,
"countmin": None, "countmin": None,
@ -151,7 +151,7 @@ Get plugin stats::
"refresh": 3.0, "refresh": 3.0,
"regex": True, "regex": True,
"result": None, "result": None,
"timer": 0.6462092399597168}] "timer": 0.6608622074127197}]
Fields descriptions: Fields descriptions:
@ -179,7 +179,7 @@ Get a specific item when field matches the given value::
"refresh": 3.0, "refresh": 3.0,
"regex": True, "regex": True,
"result": None, "result": None,
"timer": 0.6462993621826172}]} "timer": 0.6609578132629395}]}
GET cloud GET cloud
--------- ---------
@ -266,19 +266,19 @@ Get plugin stats::
# curl http://localhost:61208/api/4/cpu # curl http://localhost:61208/api/4/cpu
{"cpucore": 16, {"cpucore": 16,
"ctx_switches": 84063129, "ctx_switches": 84228136,
"guest": 0.2, "guest": 0.2,
"idle": 90.8, "idle": 92.6,
"interrupts": 68790512, "interrupts": 68946086,
"iowait": 0.1, "iowait": 0.0,
"irq": 0.0, "irq": 0.0,
"nice": 0.0, "nice": 0.0,
"soft_interrupts": 28728526, "soft_interrupts": 28794188,
"steal": 0.0, "steal": 0.0,
"syscalls": 0, "syscalls": 0,
"system": 2.8, "system": 2.8,
"total": 9.2, "total": 7.8,
"user": 6.3} "user": 4.5}
Fields descriptions: Fields descriptions:
@ -311,7 +311,7 @@ Fields descriptions:
Get a specific field:: Get a specific field::
# curl http://localhost:61208/api/4/cpu/total # curl http://localhost:61208/api/4/cpu/total
{"total": 9.2} {"total": 7.8}
GET diskio GET diskio
---------- ----------
@ -321,10 +321,10 @@ Get plugin stats::
# curl http://localhost:61208/api/4/diskio # curl http://localhost:61208/api/4/diskio
[{"disk_name": "nvme0n1", [{"disk_name": "nvme0n1",
"key": "disk_name", "key": "disk_name",
"read_bytes": 6165387776, "read_bytes": 6169893376,
"read_count": 205647, "read_count": 206146,
"write_bytes": 12850435072, "write_bytes": 12861842432,
"write_count": 456587}, "write_count": 457353},
{"disk_name": "nvme0n1p1", {"disk_name": "nvme0n1p1",
"key": "disk_name", "key": "disk_name",
"read_bytes": 7476224, "read_bytes": 7476224,
@ -364,10 +364,10 @@ Get a specific item when field matches the given value::
# curl http://localhost:61208/api/4/diskio/disk_name/nvme0n1 # curl http://localhost:61208/api/4/diskio/disk_name/nvme0n1
{"nvme0n1": [{"disk_name": "nvme0n1", {"nvme0n1": [{"disk_name": "nvme0n1",
"key": "disk_name", "key": "disk_name",
"read_bytes": 6165387776, "read_bytes": 6169893376,
"read_count": 205647, "read_count": 206146,
"write_bytes": 12850435072, "write_bytes": 12861842432,
"write_count": 456587}]} "write_count": 457353}]}
GET folders GET folders
----------- -----------
@ -394,13 +394,13 @@ Get plugin stats::
# curl http://localhost:61208/api/4/fs # curl http://localhost:61208/api/4/fs
[{"device_name": "/dev/mapper/ubuntu--vg-ubuntu--lv", [{"device_name": "/dev/mapper/ubuntu--vg-ubuntu--lv",
"free": 858858438656, "free": 858858405888,
"fs_type": "ext4", "fs_type": "ext4",
"key": "mnt_point", "key": "mnt_point",
"mnt_point": "/", "mnt_point": "/",
"percent": 9.8, "percent": 9.8,
"size": 1003736440832, "size": 1003736440832,
"used": 93815496704}] "used": 93815529472}]
Fields descriptions: Fields descriptions:
@ -421,13 +421,13 @@ Get a specific item when field matches the given value::
# curl http://localhost:61208/api/4/fs/mnt_point// # curl http://localhost:61208/api/4/fs/mnt_point//
{"/": [{"device_name": "/dev/mapper/ubuntu--vg-ubuntu--lv", {"/": [{"device_name": "/dev/mapper/ubuntu--vg-ubuntu--lv",
"free": 858858438656, "free": 858858405888,
"fs_type": "ext4", "fs_type": "ext4",
"key": "mnt_point", "key": "mnt_point",
"mnt_point": "/", "mnt_point": "/",
"percent": 9.8, "percent": 9.8,
"size": 1003736440832, "size": 1003736440832,
"used": 93815496704}]} "used": 93815529472}]}
GET gpu GET gpu
------- -------
@ -501,9 +501,9 @@ Get plugin stats::
# curl http://localhost:61208/api/4/load # curl http://localhost:61208/api/4/load
{"cpucore": 16, {"cpucore": 16,
"min1": 0.41064453125, "min1": 0.31640625,
"min15": 0.88232421875, "min15": 0.83251953125,
"min5": 0.853515625} "min5": 0.72216796875}
Fields descriptions: Fields descriptions:
@ -515,7 +515,7 @@ Fields descriptions:
Get a specific field:: Get a specific field::
# curl http://localhost:61208/api/4/load/min1 # curl http://localhost:61208/api/4/load/min1
{"min1": 0.41064453125} {"min1": 0.31640625}
GET mem GET mem
------- -------
@ -523,16 +523,16 @@ GET mem
Get plugin stats:: Get plugin stats::
# curl http://localhost:61208/api/4/mem # curl http://localhost:61208/api/4/mem
{"active": 8419315712, {"active": 8436981760,
"available": 7279529984, "available": 7259406336,
"buffers": 287682560, "buffers": 290308096,
"cached": 6897549312, "cached": 6900121600,
"free": 7279529984, "free": 7259406336,
"inactive": 5228384256, "inactive": 5231775744,
"percent": 55.7, "percent": 55.8,
"shared": 711925760, "shared": 711749632,
"total": 16422461440, "total": 16422461440,
"used": 9142931456} "used": 9163055104}
Fields descriptions: Fields descriptions:
@ -590,26 +590,26 @@ Get plugin stats::
# curl http://localhost:61208/api/4/network # curl http://localhost:61208/api/4/network
[{"alias": None, [{"alias": None,
"bytes_all": 0, "bytes_all": 0,
"bytes_all_gauge": 3364342130, "bytes_all_gauge": 3364494515,
"bytes_recv": 0, "bytes_recv": 0,
"bytes_recv_gauge": 3269811160, "bytes_recv_gauge": 3269891290,
"bytes_sent": 0, "bytes_sent": 0,
"bytes_sent_gauge": 94530970, "bytes_sent_gauge": 94603225,
"interface_name": "wlp0s20f3", "interface_name": "wlp0s20f3",
"key": "interface_name", "key": "interface_name",
"speed": 0, "speed": 0,
"time_since_update": 0.6557784080505371}, "time_since_update": 0.6713259220123291},
{"alias": None, {"alias": None,
"bytes_all": 0, "bytes_all": 0,
"bytes_all_gauge": 4128173, "bytes_all_gauge": 4137487,
"bytes_recv": 0, "bytes_recv": 0,
"bytes_recv_gauge": 856556, "bytes_recv_gauge": 860848,
"bytes_sent": 0, "bytes_sent": 0,
"bytes_sent_gauge": 3271617, "bytes_sent_gauge": 3276639,
"interface_name": "mpqemubr0", "interface_name": "mpqemubr0",
"key": "interface_name", "key": "interface_name",
"speed": 10485760000, "speed": 10485760000,
"time_since_update": 0.6557784080505371}] "time_since_update": 0.6713259220123291}]
Fields descriptions: Fields descriptions:
@ -638,15 +638,15 @@ Get a specific item when field matches the given value::
# curl http://localhost:61208/api/4/network/interface_name/wlp0s20f3 # curl http://localhost:61208/api/4/network/interface_name/wlp0s20f3
{"wlp0s20f3": [{"alias": None, {"wlp0s20f3": [{"alias": None,
"bytes_all": 0, "bytes_all": 0,
"bytes_all_gauge": 3364342130, "bytes_all_gauge": 3364494515,
"bytes_recv": 0, "bytes_recv": 0,
"bytes_recv_gauge": 3269811160, "bytes_recv_gauge": 3269891290,
"bytes_sent": 0, "bytes_sent": 0,
"bytes_sent_gauge": 94530970, "bytes_sent_gauge": 94603225,
"interface_name": "wlp0s20f3", "interface_name": "wlp0s20f3",
"key": "interface_name", "key": "interface_name",
"speed": 0, "speed": 0,
"time_since_update": 0.6557784080505371}]} "time_since_update": 0.6713259220123291}]}
GET now GET now
------- -------
@ -654,7 +654,7 @@ GET now
Get plugin stats:: Get plugin stats::
# curl http://localhost:61208/api/4/now # curl http://localhost:61208/api/4/now
{"custom": "2024-10-20 17:38:37 CEST", "iso": "2024-10-20T17:38:37+02:00"} {"custom": "2024-10-20 17:39:54 CEST", "iso": "2024-10-20T17:39:54+02:00"}
Fields descriptions: Fields descriptions:
@ -664,7 +664,7 @@ Fields descriptions:
Get a specific field:: Get a specific field::
# curl http://localhost:61208/api/4/now/iso # curl http://localhost:61208/api/4/now/iso
{"iso": "2024-10-20T17:38:37+02:00"} {"iso": "2024-10-20T17:39:54+02:00"}
GET percpu GET percpu
---------- ----------
@ -676,7 +676,7 @@ Get plugin stats::
"dpc": None, "dpc": None,
"guest": 0.0, "guest": 0.0,
"guest_nice": 0.0, "guest_nice": 0.0,
"idle": 38.0, "idle": 42.0,
"interrupt": None, "interrupt": None,
"iowait": 0.0, "iowait": 0.0,
"irq": 0.0, "irq": 0.0,
@ -684,14 +684,14 @@ Get plugin stats::
"nice": 0.0, "nice": 0.0,
"softirq": 0.0, "softirq": 0.0,
"steal": 0.0, "steal": 0.0,
"system": 2.0, "system": 1.0,
"total": 62.0, "total": 58.0,
"user": 0.0}, "user": 1.0},
{"cpu_number": 1, {"cpu_number": 1,
"dpc": None, "dpc": None,
"guest": 0.0, "guest": 0.0,
"guest_nice": 0.0, "guest_nice": 0.0,
"idle": 28.0, "idle": 34.0,
"interrupt": None, "interrupt": None,
"iowait": 0.0, "iowait": 0.0,
"irq": 0.0, "irq": 0.0,
@ -699,9 +699,9 @@ Get plugin stats::
"nice": 0.0, "nice": 0.0,
"softirq": 0.0, "softirq": 0.0,
"steal": 0.0, "steal": 0.0,
"system": 8.0, "system": 10.0,
"total": 72.0, "total": 66.0,
"user": 3.0}] "user": 0.0}]
Fields descriptions: Fields descriptions:
@ -737,7 +737,7 @@ Get plugin stats::
"port": 0, "port": 0,
"refresh": 30, "refresh": 30,
"rtt_warning": None, "rtt_warning": None,
"status": 0.047547, "status": 0.004292,
"timeout": 3}] "timeout": 3}]
Fields descriptions: Fields descriptions:
@ -765,7 +765,7 @@ Get a specific item when field matches the given value::
"port": 0, "port": 0,
"refresh": 30, "refresh": 30,
"rtt_warning": None, "rtt_warning": None,
"status": 0.047547, "status": 0.004292,
"timeout": 3}]} "timeout": 3}]}
GET processcount GET processcount
@ -774,7 +774,7 @@ GET processcount
Get plugin stats:: Get plugin stats::
# curl http://localhost:61208/api/4/processcount # curl http://localhost:61208/api/4/processcount
{"pid_max": 0, "running": 2, "sleeping": 294, "thread": 1735, "total": 435} {"pid_max": 0, "running": 1, "sleeping": 294, "thread": 1726, "total": 433}
Fields descriptions: Fields descriptions:
@ -787,7 +787,7 @@ Fields descriptions:
Get a specific field:: Get a specific field::
# curl http://localhost:61208/api/4/processcount/total # curl http://localhost:61208/api/4/processcount/total
{"total": 435} {"total": 433}
GET processlist GET processlist
--------------- ---------------
@ -830,8 +830,8 @@ Get plugin stats::
"cpu_times": {"children_system": 0.0, "cpu_times": {"children_system": 0.0,
"children_user": 0.0, "children_user": 0.0,
"iowait": 0.0, "iowait": 0.0,
"system": 22.79, "system": 22.88,
"user": 95.44}, "user": 95.76},
"gids": {"effective": 0, "real": 0, "saved": 0}, "gids": {"effective": 0, "real": 0, "saved": 0},
"io_counters": [0, 0, 0, 0, 0], "io_counters": [0, 0, 0, 0, 0],
"key": "pid", "key": "pid",
@ -845,7 +845,7 @@ Get plugin stats::
"memory_percent": 6.742347339620242, "memory_percent": 6.742347339620242,
"name": "qemu-system-x86_64", "name": "qemu-system-x86_64",
"nice": 0, "nice": 0,
"num_threads": 4, "num_threads": 5,
"pid": 2532, "pid": 2532,
"status": "S", "status": "S",
"time_since_update": 1, "time_since_update": 1,
@ -877,22 +877,22 @@ Get plugin stats::
"cpu_times": {"children_system": 0.0, "cpu_times": {"children_system": 0.0,
"children_user": 0.0, "children_user": 0.0,
"iowait": 0.0, "iowait": 0.0,
"system": 30.86, "system": 30.96,
"user": 307.59}, "user": 308.98},
"gids": {"effective": 1000, "real": 1000, "saved": 1000}, "gids": {"effective": 1000, "real": 1000, "saved": 1000},
"io_counters": [6083584, 0, 0, 0, 0], "io_counters": [6083584, 0, 0, 0, 0],
"key": "pid", "key": "pid",
"memory_info": {"data": 896737280, "memory_info": {"data": 891609088,
"dirty": 0, "dirty": 0,
"lib": 0, "lib": 0,
"rss": 925999104, "rss": 920723456,
"shared": 120307712, "shared": 120307712,
"text": 958464, "text": 958464,
"vms": 3435474944}, "vms": 3432312832},
"memory_percent": 5.638613355148788, "memory_percent": 5.606488767618017,
"name": "Isolated Web Co", "name": "Isolated Web Co",
"nice": 0, "nice": 0,
"num_threads": 30, "num_threads": 29,
"pid": 5317, "pid": 5317,
"status": "S", "status": "S",
"time_since_update": 1, "time_since_update": 1,
@ -928,19 +928,19 @@ GET quicklook
Get plugin stats:: Get plugin stats::
# curl http://localhost:61208/api/4/quicklook # curl http://localhost:61208/api/4/quicklook
{"cpu": 9.2, {"cpu": 7.8,
"cpu_hz": 4475000000.0, "cpu_hz": 4475000000.0,
"cpu_hz_current": 885117750.0, "cpu_hz_current": 710075625.0,
"cpu_log_core": 16, "cpu_log_core": 16,
"cpu_name": "13th Gen Intel(R) Core(TM) i7-13620H", "cpu_name": "13th Gen Intel(R) Core(TM) i7-13620H",
"cpu_phys_core": 10, "cpu_phys_core": 10,
"load": 5.5, "load": 5.2,
"mem": 55.7, "mem": 55.8,
"percpu": [{"cpu_number": 0, "percpu": [{"cpu_number": 0,
"dpc": None, "dpc": None,
"guest": 0.0, "guest": 0.0,
"guest_nice": 0.0, "guest_nice": 0.0,
"idle": 38.0, "idle": 42.0,
"interrupt": None, "interrupt": None,
"iowait": 0.0, "iowait": 0.0,
"irq": 0.0, "irq": 0.0,
@ -948,14 +948,14 @@ Get plugin stats::
"nice": 0.0, "nice": 0.0,
"softirq": 0.0, "softirq": 0.0,
"steal": 0.0, "steal": 0.0,
"system": 2.0, "system": 1.0,
"total": 62.0, "total": 58.0,
"user": 0.0}, "user": 1.0},
{"cpu_number": 1, {"cpu_number": 1,
"dpc": None, "dpc": None,
"guest": 0.0, "guest": 0.0,
"guest_nice": 0.0, "guest_nice": 0.0,
"idle": 28.0, "idle": 34.0,
"interrupt": None, "interrupt": None,
"iowait": 0.0, "iowait": 0.0,
"irq": 0.0, "irq": 0.0,
@ -963,14 +963,14 @@ Get plugin stats::
"nice": 0.0, "nice": 0.0,
"softirq": 0.0, "softirq": 0.0,
"steal": 0.0, "steal": 0.0,
"system": 8.0, "system": 10.0,
"total": 72.0, "total": 66.0,
"user": 3.0}, "user": 0.0},
{"cpu_number": 2, {"cpu_number": 2,
"dpc": None, "dpc": None,
"guest": 0.0, "guest": 0.0,
"guest_nice": 0.0, "guest_nice": 0.0,
"idle": 40.0, "idle": 42.0,
"interrupt": None, "interrupt": None,
"iowait": 0.0, "iowait": 0.0,
"irq": 0.0, "irq": 0.0,
@ -978,14 +978,14 @@ Get plugin stats::
"nice": 0.0, "nice": 0.0,
"softirq": 0.0, "softirq": 0.0,
"steal": 0.0, "steal": 0.0,
"system": 0.0, "system": 1.0,
"total": 60.0, "total": 58.0,
"user": 0.0}, "user": 1.0},
{"cpu_number": 3, {"cpu_number": 3,
"dpc": None, "dpc": None,
"guest": 0.0, "guest": 0.0,
"guest_nice": 0.0, "guest_nice": 0.0,
"idle": 40.0, "idle": 43.0,
"interrupt": None, "interrupt": None,
"iowait": 0.0, "iowait": 0.0,
"irq": 0.0, "irq": 0.0,
@ -994,28 +994,28 @@ Get plugin stats::
"softirq": 0.0, "softirq": 0.0,
"steal": 0.0, "steal": 0.0,
"system": 0.0, "system": 0.0,
"total": 60.0, "total": 57.0,
"user": 0.0}, "user": 0.0},
{"cpu_number": 4, {"cpu_number": 4,
"dpc": None, "dpc": None,
"guest": 0.0, "guest": 0.0,
"guest_nice": 0.0, "guest_nice": 0.0,
"idle": 16.0, "idle": 20.0,
"interrupt": None, "interrupt": None,
"iowait": 1.0, "iowait": 0.0,
"irq": 0.0, "irq": 0.0,
"key": "cpu_number", "key": "cpu_number",
"nice": 0.0, "nice": 0.0,
"softirq": 0.0, "softirq": 0.0,
"steal": 0.0, "steal": 0.0,
"system": 14.0, "system": 11.0,
"total": 84.0, "total": 80.0,
"user": 9.0}, "user": 12.0},
{"cpu_number": 5, {"cpu_number": 5,
"dpc": None, "dpc": None,
"guest": 0.0, "guest": 0.0,
"guest_nice": 0.0, "guest_nice": 0.0,
"idle": 34.0, "idle": 42.0,
"interrupt": None, "interrupt": None,
"iowait": 0.0, "iowait": 0.0,
"irq": 0.0, "irq": 0.0,
@ -1023,14 +1023,14 @@ Get plugin stats::
"nice": 0.0, "nice": 0.0,
"softirq": 0.0, "softirq": 0.0,
"steal": 0.0, "steal": 0.0,
"system": 1.0, "system": 0.0,
"total": 66.0, "total": 58.0,
"user": 5.0}, "user": 0.0},
{"cpu_number": 6, {"cpu_number": 6,
"dpc": None, "dpc": None,
"guest": 0.0, "guest": 0.0,
"guest_nice": 0.0, "guest_nice": 0.0,
"idle": 39.0, "idle": 32.0,
"interrupt": None, "interrupt": None,
"iowait": 0.0, "iowait": 0.0,
"irq": 0.0, "irq": 0.0,
@ -1038,14 +1038,14 @@ Get plugin stats::
"nice": 0.0, "nice": 0.0,
"softirq": 0.0, "softirq": 0.0,
"steal": 0.0, "steal": 0.0,
"system": 0.0, "system": 3.0,
"total": 61.0, "total": 68.0,
"user": 0.0}, "user": 7.0},
{"cpu_number": 7, {"cpu_number": 7,
"dpc": None, "dpc": None,
"guest": 0.0, "guest": 0.0,
"guest_nice": 0.0, "guest_nice": 0.0,
"idle": 34.0, "idle": 43.0,
"interrupt": None, "interrupt": None,
"iowait": 0.0, "iowait": 0.0,
"irq": 0.0, "irq": 0.0,
@ -1054,13 +1054,13 @@ Get plugin stats::
"softirq": 0.0, "softirq": 0.0,
"steal": 0.0, "steal": 0.0,
"system": 0.0, "system": 0.0,
"total": 66.0, "total": 57.0,
"user": 6.0}, "user": 0.0},
{"cpu_number": 8, {"cpu_number": 8,
"dpc": None, "dpc": None,
"guest": 0.0, "guest": 0.0,
"guest_nice": 0.0, "guest_nice": 0.0,
"idle": 34.0, "idle": 41.0,
"interrupt": None, "interrupt": None,
"iowait": 0.0, "iowait": 0.0,
"irq": 0.0, "irq": 0.0,
@ -1069,13 +1069,13 @@ Get plugin stats::
"softirq": 0.0, "softirq": 0.0,
"steal": 0.0, "steal": 0.0,
"system": 1.0, "system": 1.0,
"total": 66.0, "total": 59.0,
"user": 4.0}, "user": 1.0},
{"cpu_number": 9, {"cpu_number": 9,
"dpc": None, "dpc": None,
"guest": 0.0, "guest": 0.0,
"guest_nice": 0.0, "guest_nice": 0.0,
"idle": 40.0, "idle": 43.0,
"interrupt": None, "interrupt": None,
"iowait": 0.0, "iowait": 0.0,
"irq": 0.0, "irq": 0.0,
@ -1084,73 +1084,13 @@ Get plugin stats::
"softirq": 0.0, "softirq": 0.0,
"steal": 0.0, "steal": 0.0,
"system": 0.0, "system": 0.0,
"total": 60.0, "total": 57.0,
"user": 0.0}, "user": 0.0},
{"cpu_number": 10, {"cpu_number": 10,
"dpc": None, "dpc": None,
"guest": 0.0, "guest": 0.0,
"guest_nice": 0.0, "guest_nice": 0.0,
"idle": 40.0, "idle": 43.0,
"interrupt": None,
"iowait": 0.0,
"irq": 0.0,
"key": "cpu_number",
"nice": 0.0,
"softirq": 0.0,
"steal": 0.0,
"system": 0.0,
"total": 60.0,
"user": 0.0},
{"cpu_number": 11,
"dpc": None,
"guest": 0.0,
"guest_nice": 0.0,
"idle": 35.0,
"interrupt": None,
"iowait": 0.0,
"irq": 0.0,
"key": "cpu_number",
"nice": 0.0,
"softirq": 0.0,
"steal": 0.0,
"system": 0.0,
"total": 65.0,
"user": 6.0},
{"cpu_number": 12,
"dpc": None,
"guest": 0.0,
"guest_nice": 0.0,
"idle": 40.0,
"interrupt": None,
"iowait": 0.0,
"irq": 0.0,
"key": "cpu_number",
"nice": 0.0,
"softirq": 0.0,
"steal": 0.0,
"system": 0.0,
"total": 60.0,
"user": 0.0},
{"cpu_number": 13,
"dpc": None,
"guest": 0.0,
"guest_nice": 0.0,
"idle": 40.0,
"interrupt": None,
"iowait": 0.0,
"irq": 0.0,
"key": "cpu_number",
"nice": 0.0,
"softirq": 0.0,
"steal": 0.0,
"system": 0.0,
"total": 60.0,
"user": 0.0},
{"cpu_number": 14,
"dpc": None,
"guest": 0.0,
"guest_nice": 0.0,
"idle": 39.0,
"interrupt": None, "interrupt": None,
"iowait": 0.0, "iowait": 0.0,
"irq": 0.0, "irq": 0.0,
@ -1159,13 +1099,13 @@ Get plugin stats::
"softirq": 0.0, "softirq": 0.0,
"steal": 0.0, "steal": 0.0,
"system": 1.0, "system": 1.0,
"total": 61.0, "total": 57.0,
"user": 0.0}, "user": 1.0},
{"cpu_number": 15, {"cpu_number": 11,
"dpc": None, "dpc": None,
"guest": 0.0, "guest": 0.0,
"guest_nice": 0.0, "guest_nice": 0.0,
"idle": 39.0, "idle": 44.0,
"interrupt": None, "interrupt": None,
"iowait": 0.0, "iowait": 0.0,
"irq": 0.0, "irq": 0.0,
@ -1174,7 +1114,67 @@ Get plugin stats::
"softirq": 0.0, "softirq": 0.0,
"steal": 0.0, "steal": 0.0,
"system": 0.0, "system": 0.0,
"total": 61.0, "total": 56.0,
"user": 0.0},
{"cpu_number": 12,
"dpc": None,
"guest": 0.0,
"guest_nice": 0.0,
"idle": 42.0,
"interrupt": None,
"iowait": 0.0,
"irq": 0.0,
"key": "cpu_number",
"nice": 0.0,
"softirq": 0.0,
"steal": 0.0,
"system": 0.0,
"total": 58.0,
"user": 1.0},
{"cpu_number": 13,
"dpc": None,
"guest": 0.0,
"guest_nice": 0.0,
"idle": 43.0,
"interrupt": None,
"iowait": 0.0,
"irq": 0.0,
"key": "cpu_number",
"nice": 0.0,
"softirq": 0.0,
"steal": 0.0,
"system": 0.0,
"total": 57.0,
"user": 0.0},
{"cpu_number": 14,
"dpc": None,
"guest": 0.0,
"guest_nice": 0.0,
"idle": 43.0,
"interrupt": None,
"iowait": 0.0,
"irq": 0.0,
"key": "cpu_number",
"nice": 0.0,
"softirq": 0.0,
"steal": 0.0,
"system": 0.0,
"total": 57.0,
"user": 0.0},
{"cpu_number": 15,
"dpc": None,
"guest": 0.0,
"guest_nice": 0.0,
"idle": 43.0,
"interrupt": None,
"iowait": 0.0,
"irq": 0.0,
"key": "cpu_number",
"nice": 0.0,
"softirq": 0.0,
"steal": 0.0,
"system": 0.0,
"total": 57.0,
"user": 0.0}], "user": 0.0}],
"swap": 0.1} "swap": 0.1}
@ -1214,7 +1214,7 @@ Get plugin stats::
"label": "Ambient", "label": "Ambient",
"type": "temperature_core", "type": "temperature_core",
"unit": "C", "unit": "C",
"value": 35, "value": 34,
"warning": 0}, "warning": 0},
{"critical": None, {"critical": None,
"key": "label", "key": "label",
@ -1282,7 +1282,7 @@ Get a specific item when field matches the given value::
"label": "Ambient", "label": "Ambient",
"type": "temperature_core", "type": "temperature_core",
"unit": "C", "unit": "C",
"value": 35, "value": 34,
"warning": 0}]} "warning": 0}]}
GET smart GET smart
@ -1326,7 +1326,7 @@ GET uptime
Get plugin stats:: Get plugin stats::
# curl http://localhost:61208/api/4/uptime # curl http://localhost:61208/api/4/uptime
"1 day, 1:43:26" "1 day, 1:44:43"
GET version GET version
----------- -----------
@ -1352,7 +1352,7 @@ Get plugin stats::
"load_1min": 0, "load_1min": 0,
"load_5min": 0, "load_5min": 0,
"memory_total": 1002496000, "memory_total": 1002496000,
"memory_usage": 338034688, "memory_usage": 338026496,
"name": "upstanding-sparrow", "name": "upstanding-sparrow",
"release": "Ubuntu 24.04.1 LTS", "release": "Ubuntu 24.04.1 LTS",
"status": "running"}] "status": "running"}]
@ -1391,7 +1391,7 @@ Get a specific item when field matches the given value::
"load_1min": 0, "load_1min": 0,
"load_5min": 0, "load_5min": 0,
"memory_total": 1002496000, "memory_total": 1002496000,
"memory_usage": 338034688, "memory_usage": 338026496,
"name": "upstanding-sparrow", "name": "upstanding-sparrow",
"release": "Ubuntu 24.04.1 LTS", "release": "Ubuntu 24.04.1 LTS",
"status": "running"}]} "status": "running"}]}
@ -1403,8 +1403,8 @@ Get plugin stats::
# curl http://localhost:61208/api/4/wifi # curl http://localhost:61208/api/4/wifi
[{"key": "ssid", [{"key": "ssid",
"quality_level": -71.0, "quality_level": -68.0,
"quality_link": 39.0, "quality_link": 42.0,
"ssid": "wlp0s20f3"}] "ssid": "wlp0s20f3"}]
Get a specific field:: Get a specific field::
@ -1416,8 +1416,8 @@ Get a specific item when field matches the given value::
# curl http://localhost:61208/api/4/wifi/ssid/wlp0s20f3 # curl http://localhost:61208/api/4/wifi/ssid/wlp0s20f3
{"wlp0s20f3": [{"key": "ssid", {"wlp0s20f3": [{"key": "ssid",
"quality_level": -71.0, "quality_level": -68.0,
"quality_link": 39.0, "quality_link": 42.0,
"ssid": "wlp0s20f3"}]} "ssid": "wlp0s20f3"}]}
GET all stats GET all stats
@ -1462,34 +1462,34 @@ GET stats history
History of a plugin:: History of a plugin::
# curl http://localhost:61208/api/4/cpu/history # curl http://localhost:61208/api/4/cpu/history
{"system": [["2024-10-20T17:38:38.497414", 2.8], {"system": [["2024-10-20T17:39:55.042767", 2.8],
["2024-10-20T17:38:39.815505", 1.1], ["2024-10-20T17:39:56.360215", 1.0],
["2024-10-20T17:38:40.827282", 1.1]], ["2024-10-20T17:39:57.372778", 1.0]],
"user": [["2024-10-20T17:38:38.497408", 6.3], "user": [["2024-10-20T17:39:55.042763", 4.5],
["2024-10-20T17:38:39.815501", 3.3], ["2024-10-20T17:39:56.360210", 1.0],
["2024-10-20T17:38:40.827276", 3.3]]} ["2024-10-20T17:39:57.372771", 1.0]]}
Limit history to last 2 values:: Limit history to last 2 values::
# curl http://localhost:61208/api/4/cpu/history/2 # curl http://localhost:61208/api/4/cpu/history/2
{"system": [["2024-10-20T17:38:39.815505", 1.1], {"system": [["2024-10-20T17:39:56.360215", 1.0],
["2024-10-20T17:38:40.827282", 1.1]], ["2024-10-20T17:39:57.372778", 1.0]],
"user": [["2024-10-20T17:38:39.815501", 3.3], "user": [["2024-10-20T17:39:56.360210", 1.0],
["2024-10-20T17:38:40.827276", 3.3]]} ["2024-10-20T17:39:57.372771", 1.0]]}
History for a specific field:: History for a specific field::
# curl http://localhost:61208/api/4/cpu/system/history # curl http://localhost:61208/api/4/cpu/system/history
{"system": [["2024-10-20T17:38:37.320402", 2.8], {"system": [["2024-10-20T17:39:53.898925", 2.8],
["2024-10-20T17:38:38.497414", 2.8], ["2024-10-20T17:39:55.042767", 2.8],
["2024-10-20T17:38:39.815505", 1.1], ["2024-10-20T17:39:56.360215", 1.0],
["2024-10-20T17:38:40.827282", 1.1]]} ["2024-10-20T17:39:57.372778", 1.0]]}
Limit history for a specific field to last 2 values:: Limit history for a specific field to last 2 values::
# curl http://localhost:61208/api/4/cpu/system/history # curl http://localhost:61208/api/4/cpu/system/history
{"system": [["2024-10-20T17:38:39.815505", 1.1], {"system": [["2024-10-20T17:39:56.360215", 1.0],
["2024-10-20T17:38:40.827282", 1.1]]} ["2024-10-20T17:39:57.372778", 1.0]]}
GET limits (used for thresholds) GET limits (used for thresholds)
-------------------------------- --------------------------------