diff --git a/README.rst b/README.rst index cc29806b..7232704f 100644 --- a/README.rst +++ b/README.rst @@ -124,6 +124,7 @@ Optional dependencies: - ``podman`` (for the Containers Podman monitoring support) - ``potsdb`` (for the OpenTSDB export module) - ``prometheus_client`` (for the Prometheus export module) +- ``psycopg[binary]`` (for the PostgreSQL/TimeScale export module) - ``pygal`` (for the graph export module) - ``pymdstat`` (for RAID support) [Linux-only] - ``pymongo`` (for the MongoDB export module) @@ -410,12 +411,13 @@ Shell tab completion Glances 4.3.2 and higher includes shell tab autocompletion thanks to the --print-completion option. -For example, on a Linux operating system with Bash shell: +For example, on a Linux operating system with bash shell: .. code-block:: console - $ glances --print-completion bash | sudo tee -a /etc/bash_completion.d/glances - $ source /etc/bash_completion.d/glances + $ mkdir -p ${XDG_DATA_HOME:="$HOME/.local/share"}/bash-completion + $ glances --print-completion bash > ${XDG_DATA_HOME:="$HOME/.local/share"}/bash-completion/glances + $ source ${XDG_DATA_HOME:="$HOME/.local/share"}/bash-completion/glances Following shells are supported: bash, zsh and tcsh. @@ -501,9 +503,23 @@ If you have any question (after RTFM!), please post it on the official Q&A `foru Gateway to other services ========================= -Glances can export stats to: ``CSV`` file, ``JSON`` file, ``InfluxDB``, ``Cassandra``, ``CouchDB``, -``OpenTSDB``, ``Prometheus``, ``StatsD``, ``ElasticSearch``, ``RabbitMQ/ActiveMQ``, -``ZeroMQ``, ``Kafka``, ``Riemann``, ``Graphite`` and ``RESTful`` server. +Glances can export stats to: +- ``CSV`` file +- ``JSON`` file +- ``InfluxDB`` server +- ``Cassandra`` server +- ``CouchDB`` server +- ``OpenTSDB`` server +- ``Prometheus`` server +- ``StatsD`` server +- ``ElasticSearch`` server +- ``PostgreSQL/TimeScale`` server +- ``RabbitMQ/ActiveMQ`` broker +- ``ZeroMQ`` broker +- ``Kafka`` broker +- ``Riemann`` server +- ``Graphite`` server +- ``RESTful`` endpoint How to contribute ? =================== diff --git a/docs/api.rst b/docs/api.rst index fbd27e10..5fbb680e 100644 --- a/docs/api.rst +++ b/docs/api.rst @@ -160,7 +160,7 @@ Get plugin stats:: "refresh": 3.0, "regex": True, "result": None, - "timer": 0.2667412757873535}, + "timer": 0.47481369972229004}, {"count": 0, "countmax": 20.0, "countmin": None, @@ -169,7 +169,7 @@ Get plugin stats:: "refresh": 3.0, "regex": True, "result": None, - "timer": 0.26668334007263184}] + "timer": 0.47472500801086426}] Fields descriptions: @@ -197,7 +197,7 @@ Get a specific item when field matches the given value:: "refresh": 3.0, "regex": True, "result": None, - "timer": 0.2667412757873535}]} + "timer": 0.47481369972229004}]} GET cloud --------- @@ -245,23 +245,23 @@ Get plugin stats:: "engine": "docker", "id": "454a8c7f059271f0e7fbb757375014115db3b6e0df2c039e66bb2647f717f67e", "image": ["timescale/timescaledb-ha:pg17"], - "io": {"cumulative_ior": 142053376, "cumulative_iow": 0}, + "io": {"cumulative_ior": 142082048, "cumulative_iow": 0}, "io_rx": None, "io_wx": None, "key": "name", "memory": {"inactive_file": 11075584, "limit": 16421875712, - "usage": 76955648}, + "usage": 73662464}, "memory_inactive_file": 11075584, "memory_limit": 16421875712, "memory_percent": None, - "memory_usage": 76955648, + "memory_usage": 73662464, "name": "timescaledb-for-glances", - "network": {"cumulative_rx": 746575, "cumulative_tx": 181084}, + "network": {"cumulative_rx": 853694, "cumulative_tx": 181084}, "network_rx": None, "network_tx": None, "status": "running", - "uptime": "6 days"}] + "uptime": "a week"}] Fields descriptions: @@ -299,25 +299,25 @@ Get a specific item when field matches the given value:: "engine": "docker", "id": "454a8c7f059271f0e7fbb757375014115db3b6e0df2c039e66bb2647f717f67e", "image": ["timescale/timescaledb-ha:pg17"], - "io": {"cumulative_ior": 142053376, + "io": {"cumulative_ior": 142082048, "cumulative_iow": 0}, "io_rx": None, "io_wx": None, "key": "name", "memory": {"inactive_file": 11075584, "limit": 16421875712, - "usage": 76955648}, + "usage": 73662464}, "memory_inactive_file": 11075584, "memory_limit": 16421875712, "memory_percent": None, - "memory_usage": 76955648, + "memory_usage": 73662464, "name": "timescaledb-for-glances", - "network": {"cumulative_rx": 746575, + "network": {"cumulative_rx": 853694, "cumulative_tx": 181084}, "network_rx": None, "network_tx": None, "status": "running", - "uptime": "6 days"}]} + "uptime": "a week"}]} GET core -------- @@ -344,19 +344,19 @@ Get plugin stats:: # curl http://localhost:61208/api/4/cpu {"cpucore": 16, - "ctx_switches": 1036350185, + "ctx_switches": 1092357433, "guest": 0.0, - "idle": 93.1, - "interrupts": 467005540, - "iowait": 0.1, + "idle": 92.1, + "interrupts": 498018187, + "iowait": 0.5, "irq": 0.0, "nice": 0.0, - "soft_interrupts": 124341201, + "soft_interrupts": 142021762, "steal": 0.0, "syscalls": 0, - "system": 2.5, - "total": 6.3, - "user": 4.3} + "system": 2.9, + "total": 6.9, + "user": 4.5} Fields descriptions: @@ -389,7 +389,7 @@ Fields descriptions: Get a specific field:: # curl http://localhost:61208/api/4/cpu/total - {"total": 6.3} + {"total": 6.9} GET diskio ---------- @@ -399,14 +399,14 @@ Get plugin stats:: # curl http://localhost:61208/api/4/diskio [{"disk_name": "nvme0n1", "key": "disk_name", - "read_bytes": 23279049728, - "read_count": 1259706, - "write_bytes": 38704964608, - "write_count": 3693618}, + "read_bytes": 23662305280, + "read_count": 1285414, + "write_bytes": 42966279168, + "write_count": 3912353}, {"disk_name": "nvme0n1p1", "key": "disk_name", - "read_bytes": 15139328, - "read_count": 1226, + "read_bytes": 16233984, + "read_count": 1635, "write_bytes": 1024, "write_count": 2}] @@ -442,10 +442,10 @@ Get a specific item when field matches the given value:: # curl http://localhost:61208/api/4/diskio/disk_name/value/nvme0n1 {"nvme0n1": [{"disk_name": "nvme0n1", "key": "disk_name", - "read_bytes": 23279049728, - "read_count": 1259706, - "write_bytes": 38704964608, - "write_count": 3693618}]} + "read_bytes": 23662305280, + "read_count": 1285414, + "write_bytes": 42966279168, + "write_count": 3912353}]} GET folders ----------- @@ -472,14 +472,14 @@ Get plugin stats:: # curl http://localhost:61208/api/4/fs [{"device_name": "/dev/mapper/ubuntu--vg-ubuntu--lv", - "free": 758818922496, + "free": 757348794368, "fs_type": "ext4", "key": "mnt_point", "mnt_point": "/", "options": "rw,relatime", - "percent": 20.3, + "percent": 20.5, "size": 1003736440832, - "used": 193855012864}, + "used": 195325140992}, {"device_name": "zsfpool", "free": 41680896, "fs_type": "zfs", @@ -510,14 +510,14 @@ Get a specific item when field matches the given value:: # curl http://localhost:61208/api/4/fs/mnt_point/value// {"/": [{"device_name": "/dev/mapper/ubuntu--vg-ubuntu--lv", - "free": 758818922496, + "free": 757348794368, "fs_type": "ext4", "key": "mnt_point", "mnt_point": "/", "options": "rw,relatime", - "percent": 20.3, + "percent": 20.5, "size": 1003736440832, - "used": 193855012864}]} + "used": 195325140992}]} GET gpu ------- @@ -589,7 +589,7 @@ GET load Get plugin stats:: # curl http://localhost:61208/api/4/load - {"cpucore": 16, "min1": 1.27734375, "min15": 1.0546875, "min5": 1.30419921875} + {"cpucore": 16, "min1": 0.8486328125, "min15": 0.51953125, "min5": 0.5673828125} Fields descriptions: @@ -601,7 +601,7 @@ Fields descriptions: Get a specific field:: # curl http://localhost:61208/api/4/load/min1 - {"min1": 1.27734375} + {"min1": 0.8486328125} GET mem ------- @@ -609,16 +609,16 @@ GET mem Get plugin stats:: # curl http://localhost:61208/api/4/mem - {"active": 8428093440, - "available": 4372918272, - "buffers": 292761600, - "cached": 4329754624, - "free": 4372918272, - "inactive": 5006258176, - "percent": 73.4, - "shared": 726491136, + {"active": 6821453824, + "available": 5580181504, + "buffers": 240480256, + "cached": 5894012928, + "free": 5580181504, + "inactive": 6609973248, + "percent": 66.0, + "shared": 845099008, "total": 16421875712, - "used": 12048957440} + "used": 10841694208} Fields descriptions: @@ -645,13 +645,13 @@ GET memswap Get plugin stats:: # curl http://localhost:61208/api/4/memswap - {"free": 632795136, - "percent": 85.3, - "sin": 1992822784, - "sout": 9242300416, + {"free": 605421568, + "percent": 85.9, + "sin": 2137960448, + "sout": 9439567872, "time_since_update": 1, "total": 4294963200, - "used": 3662168064} + "used": 3689541632} Fields descriptions: @@ -676,32 +676,32 @@ Get plugin stats:: # curl http://localhost:61208/api/4/network [{"alias": None, "bytes_all": 0, - "bytes_all_gauge": 2409379220, + "bytes_all_gauge": 3507317697, "bytes_all_rate_per_sec": 0, "bytes_recv": 0, - "bytes_recv_gauge": 1931364828, + "bytes_recv_gauge": 2938594709, "bytes_recv_rate_per_sec": 0, "bytes_sent": 0, - "bytes_sent_gauge": 478014392, + "bytes_sent_gauge": 568722988, "bytes_sent_rate_per_sec": 0, "interface_name": "wlp0s20f3", "key": "interface_name", "speed": 0, - "time_since_update": 0.2683117389678955}, + "time_since_update": 0.4779174327850342}, {"alias": None, "bytes_all": 0, - "bytes_all_gauge": 927659, + "bytes_all_gauge": 1034778, "bytes_all_rate_per_sec": 0, "bytes_recv": 0, "bytes_recv_gauge": 181084, "bytes_recv_rate_per_sec": 0, "bytes_sent": 0, - "bytes_sent_gauge": 746575, + "bytes_sent_gauge": 853694, "bytes_sent_rate_per_sec": 0, "interface_name": "veth620fda1", "key": "interface_name", "speed": 10485760000, - "time_since_update": 0.2683117389678955}] + "time_since_update": 0.4779174327850342}] Fields descriptions: @@ -730,18 +730,18 @@ Get a specific item when field matches the given value:: # curl http://localhost:61208/api/4/network/interface_name/value/wlp0s20f3 {"wlp0s20f3": [{"alias": None, "bytes_all": 0, - "bytes_all_gauge": 2409379220, + "bytes_all_gauge": 3507317697, "bytes_all_rate_per_sec": 0, "bytes_recv": 0, - "bytes_recv_gauge": 1931364828, + "bytes_recv_gauge": 2938594709, "bytes_recv_rate_per_sec": 0, "bytes_sent": 0, - "bytes_sent_gauge": 478014392, + "bytes_sent_gauge": 568722988, "bytes_sent_rate_per_sec": 0, "interface_name": "wlp0s20f3", "key": "interface_name", "speed": 0, - "time_since_update": 0.2683117389678955}]} + "time_since_update": 0.4779174327850342}]} GET now ------- @@ -749,7 +749,7 @@ GET now Get plugin stats:: # curl http://localhost:61208/api/4/now - {"custom": "2025-06-29 14:31:40 CEST", "iso": "2025-06-29T14:31:40+02:00"} + {"custom": "2025-06-30 08:03:52 CEST", "iso": "2025-06-30T08:03:52+02:00"} Fields descriptions: @@ -759,7 +759,7 @@ Fields descriptions: Get a specific field:: # curl http://localhost:61208/api/4/now/iso - {"iso": "2025-06-29T14:31:40+02:00"} + {"iso": "2025-06-30T08:03:52+02:00"} GET percpu ---------- @@ -771,22 +771,22 @@ Get plugin stats:: "dpc": None, "guest": 0.0, "guest_nice": 0.0, - "idle": 21.0, + "idle": 36.0, "interrupt": None, - "iowait": 0.0, + "iowait": 1.0, "irq": 0.0, "key": "cpu_number", "nice": 0.0, "softirq": 0.0, "steal": 0.0, - "system": 4.0, - "total": 79.0, + "system": 7.0, + "total": 64.0, "user": 0.0}, {"cpu_number": 1, "dpc": None, "guest": 0.0, "guest_nice": 0.0, - "idle": 26.0, + "idle": 46.0, "interrupt": None, "iowait": 0.0, "irq": 0.0, @@ -795,7 +795,7 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 74.0, + "total": 54.0, "user": 0.0}] Fields descriptions: @@ -832,7 +832,7 @@ Get plugin stats:: "port": 0, "refresh": 30, "rtt_warning": None, - "status": 0.016359, + "status": 0.016374, "timeout": 3}] Fields descriptions: @@ -860,7 +860,7 @@ Get a specific item when field matches the given value:: "port": 0, "refresh": 30, "rtt_warning": None, - "status": 0.016359, + "status": 0.016374, "timeout": 3}]} GET processcount @@ -869,7 +869,7 @@ GET processcount Get plugin stats:: # curl http://localhost:61208/api/4/processcount - {"pid_max": 0, "running": 1, "sleeping": 440, "thread": 2464, "total": 586} + {"pid_max": 0, "running": 1, "sleeping": 436, "thread": 2343, "total": 583} Fields descriptions: @@ -882,7 +882,7 @@ Fields descriptions: Get a specific field:: # curl http://localhost:61208/api/4/processcount/total - {"total": 586} + {"total": 583} GET processlist --------------- @@ -914,28 +914,28 @@ Get plugin stats:: "--disable-features=CalculateNativeWinOcclusion,SpareRendererForSitePerProcess", "--variations-seed-version"], "cpu_percent": 0.0, - "cpu_times": {"children_system": 1309.62, - "children_user": 394.99, + "cpu_times": {"children_system": 1543.56, + "children_user": 450.0, "iowait": 0.0, - "system": 961.42, - "user": 2239.49}, + "system": 1170.71, + "user": 2586.27}, "gids": {"effective": 1000, "real": 1000, "saved": 1000}, - "io_counters": [1083468800, - 901427200, + "io_counters": [1105124352, + 946724864, 0, 0, 0, - 82058240, + 41866240, + 245760, + 0, + 0, + 0, + 82590720, 761856, 0, 0, 0, - 38276096, - 233472, - 0, - 0, - 0, - 73820160, + 73824256, 0, 0, 0, @@ -945,18 +945,13 @@ Get plugin stats:: 0, 0, 0, - 74399744, - 150335488, + 75506688, + 171302912, 0, 0, 0, - 27551744, - 286720, - 0, - 0, - 0, - 4582400, - 0, + 47408128, + 1474125824, 0, 0, 0, @@ -965,7 +960,12 @@ Get plugin stats:: 0, 0, 0, - 68940800, + 69190656, + 0, + 0, + 0, + 0, + 4582400, 0, 0, 0, @@ -975,53 +975,53 @@ Get plugin stats:: 0, 0, 0, - 37030912, - 323584, - 0, - 0, - 0, 2440192, 0, 0, 0, 0, - 763904, - 0, - 0, - 0, - 0, - 3002368, - 0, - 0, - 0, - 0, 570368, 0, 0, 0, 0, + 763904, + 0, + 0, + 0, + 0, 1370112, 0, 0, 0, 0, - 1665024, + 37030912, + 323584, + 0, + 0, + 0, + 3002368, 0, 0, 0, 0, - 1431552, + 1824768, 0, 0, 0, 0, - 8032256, + 1480704, 0, 0, 0, 0, - 2445312, - 8368128, + 8507392, + 0, + 0, + 0, + 0, + 6110208, + 11436032, 0, 0, 0, @@ -1036,47 +1036,45 @@ Get plugin stats:: 0, 0], "key": "pid", - "memory_info": {"data": 4378673152, + "memory_info": {"data": 4177715200, "dirty": 0, "lib": 0, - "rss": 2001448960, - "shared": 90640384, + "rss": 1755660288, + "shared": 86052864, "text": 142934016, - "vms": 1527962394624}, - "memory_percent": 12.18770008433005, + "vms": 1526241415168}, + "memory_percent": 10.690985115160029, "name": "code", "nice": 0, - "num_threads": 82, + "num_threads": 75, "pid": 344596, "status": "S", "time_since_update": 1, "username": "nicolargo"}, {"cmdline": ["/snap/code/196/usr/share/code/code", - "/home/nicolargo/.vscode/extensions/ms-python.vscode-pylance-2025.6.1/dist/server.bundle.js", - "--cancellationReceive=file:60578a1abad334f41c06e506754f5f0e9d4d228a26", - "--node-ipc", - "--clientProcessId=344596"], + "--type=zygote", + "--no-sandbox"], "cpu_percent": 0.0, - "cpu_times": {"children_system": 0.26, - "children_user": 1.88, + "cpu_times": {"children_system": 0.0, + "children_user": 0.0, "iowait": 0.0, - "system": 30.4, - "user": 495.64}, + "system": 165.24, + "user": 1982.29}, "gids": {"effective": 1000, "real": 1000, "saved": 1000}, - "io_counters": [82058240, 761856, 0, 0, 0], + "io_counters": [41866240, 245760, 0, 0, 0], "key": "pid", - "memory_info": {"data": 2461933568, + "memory_info": {"data": 2355363840, "dirty": 0, "lib": 0, - "rss": 1266327552, - "shared": 72187904, + "rss": 1061679104, + "shared": 101523456, "text": 142934016, - "vms": 1501479981056}, - "memory_percent": 7.711223578891498, + "vms": 1528181399552}, + "memory_percent": 6.4650294681270575, "name": "code", "nice": 0, - "num_threads": 16, - "pid": 345057, + "num_threads": 41, + "pid": 344538, "status": "S", "time_since_update": 1, "username": "nicolargo"}] @@ -1104,22 +1102,22 @@ Get plugin stats:: # curl http://localhost:61208/api/4/programlist [{"childrens": [344596, - 345057, 344538, + 345057, 345617, 538299, 344413, 344606, - 538298, 538473, 344607, + 538298, 757571, - 538321, 703317, - 344509, - 538456, 750052, + 344509, 703318, + 538321, + 538456, 344729, 344987, 345280, @@ -1128,26 +1126,26 @@ Get plugin stats:: 344415], "cmdline": ["code"], "cpu_percent": 0, - "cpu_times": {"children_system": 1310.3599999999997, - "children_user": 398.72, - "system": 1361.64, - "user": 5402.949999999999}, - "io_counters": [1083468800, - 901427200, + "cpu_times": {"children_system": 1545.1399999999999, + "children_user": 458.76000000000005, + "system": 1643.1800000000007, + "user": 6116.319999999998}, + "io_counters": [1105124352, + 946724864, 0, 0, 0, - 82058240, + 41866240, + 245760, + 0, + 0, + 0, + 82590720, 761856, 0, 0, 0, - 38276096, - 233472, - 0, - 0, - 0, - 73820160, + 73824256, 0, 0, 0, @@ -1157,18 +1155,13 @@ Get plugin stats:: 0, 0, 0, - 74399744, - 150335488, + 75506688, + 171302912, 0, 0, 0, - 27551744, - 286720, - 0, - 0, - 0, - 4582400, - 0, + 47408128, + 1474125824, 0, 0, 0, @@ -1177,7 +1170,12 @@ Get plugin stats:: 0, 0, 0, - 68940800, + 69190656, + 0, + 0, + 0, + 0, + 4582400, 0, 0, 0, @@ -1187,53 +1185,53 @@ Get plugin stats:: 0, 0, 0, - 37030912, - 323584, - 0, - 0, - 0, 2440192, 0, 0, 0, 0, - 763904, - 0, - 0, - 0, - 0, - 3002368, - 0, - 0, - 0, - 0, 570368, 0, 0, 0, 0, + 763904, + 0, + 0, + 0, + 0, 1370112, 0, 0, 0, 0, - 1665024, + 37030912, + 323584, + 0, + 0, + 0, + 3002368, 0, 0, 0, 0, - 1431552, + 1824768, 0, 0, 0, 0, - 8032256, + 1480704, 0, 0, 0, 0, - 2445312, - 8368128, + 8507392, + 0, + 0, + 0, + 0, + 6110208, + 11436032, 0, 0, 0, @@ -1247,41 +1245,41 @@ Get plugin stats:: 0, 0, 0], - "memory_info": {"data": 21126369280, - "rss": 6415523840, - "shared": 1656578048, + "memory_info": {"data": 20879228928, + "rss": 5842026496, + "shared": 1605451776, "text": 3287482368, - "vms": 28609931362304}, - "memory_percent": 39.06693700837089, + "vms": 28613465911296}, + "memory_percent": 35.57466027909979, "name": "code", "nice": 0, "nprocs": 23, - "num_threads": 383, + "num_threads": 379, "pid": "_", "status": "S", "time_since_update": 1, "username": "nicolargo"}, - {"childrens": [345567], - "cmdline": ["cloudcode_cli"], + {"childrens": [9654], + "cmdline": ["WebExtensions"], "cpu_percent": 0, "cpu_times": {"children_system": 0.0, "children_user": 0.0, "iowait": 0.0, - "system": 13.82, - "user": 131.3}, - "io_counters": [370257920, 0, 0, 0, 0], - "memory_info": {"data": 1580412928, + "system": 135.48, + "user": 878.1}, + "io_counters": [86463488, 0, 0, 0, 0], + "memory_info": {"data": 1218269184, "dirty": 0, "lib": 0, - "rss": 1114238976, - "shared": 14553088, - "text": 33955840, - "vms": 2864644096}, - "memory_percent": 6.785089569188428, - "name": "cloudcode_cli", + "rss": 629018624, + "shared": 97775616, + "text": 868352, + "vms": 25438253056}, + "memory_percent": 3.830370141824637, + "name": "WebExtensions", "nice": 0, "nprocs": 1, - "num_threads": 20, + "num_threads": 29, "pid": "_", "status": "S", "time_since_update": 1, @@ -1317,94 +1315,34 @@ GET quicklook Get plugin stats:: # curl http://localhost:61208/api/4/quicklook - {"cpu": 6.3, + {"cpu": 6.9, "cpu_hz": 4475000000.0, - "cpu_hz_current": 1436756875.0, + "cpu_hz_current": 895664875.0, "cpu_log_core": 16, "cpu_name": "13th Gen Intel(R) Core(TM) i7-13620H", "cpu_phys_core": 10, - "load": 6.6, - "mem": 73.4, + "load": 3.2, + "mem": 66.0, "percpu": [{"cpu_number": 0, "dpc": None, "guest": 0.0, "guest_nice": 0.0, - "idle": 21.0, + "idle": 36.0, "interrupt": None, - "iowait": 0.0, - "irq": 0.0, - "key": "cpu_number", - "nice": 0.0, - "softirq": 0.0, - "steal": 0.0, - "system": 4.0, - "total": 79.0, - "user": 0.0}, - {"cpu_number": 1, - "dpc": None, - "guest": 0.0, - "guest_nice": 0.0, - "idle": 26.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": 74.0, - "user": 0.0}, - {"cpu_number": 2, - "dpc": None, - "guest": 0.0, - "guest_nice": 0.0, - "idle": 23.0, - "interrupt": None, - "iowait": 0.0, - "irq": 0.0, - "key": "cpu_number", - "nice": 0.0, - "softirq": 0.0, - "steal": 0.0, - "system": 3.0, - "total": 77.0, - "user": 0.0}, - {"cpu_number": 3, - "dpc": None, - "guest": 0.0, - "guest_nice": 0.0, - "idle": 26.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": 74.0, - "user": 0.0}, - {"cpu_number": 4, - "dpc": None, - "guest": 0.0, - "guest_nice": 0.0, - "idle": 11.0, - "interrupt": None, - "iowait": 0.0, + "iowait": 1.0, "irq": 0.0, "key": "cpu_number", "nice": 0.0, "softirq": 0.0, "steal": 0.0, "system": 7.0, - "total": 89.0, - "user": 6.0}, - {"cpu_number": 5, + "total": 64.0, + "user": 0.0}, + {"cpu_number": 1, "dpc": None, "guest": 0.0, "guest_nice": 0.0, - "idle": 26.0, + "idle": 46.0, "interrupt": None, "iowait": 0.0, "irq": 0.0, @@ -1413,9 +1351,54 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 74.0, + "total": 54.0, "user": 0.0}, - {"cpu_number": 6, + {"cpu_number": 2, + "dpc": None, + "guest": 0.0, + "guest_nice": 0.0, + "idle": 46.0, + "interrupt": None, + "iowait": 0.0, + "irq": 0.0, + "key": "cpu_number", + "nice": 0.0, + "softirq": 0.0, + "steal": 0.0, + "system": 1.0, + "total": 54.0, + "user": 0.0}, + {"cpu_number": 3, + "dpc": None, + "guest": 0.0, + "guest_nice": 0.0, + "idle": 46.0, + "interrupt": None, + "iowait": 1.0, + "irq": 0.0, + "key": "cpu_number", + "nice": 0.0, + "softirq": 0.0, + "steal": 0.0, + "system": 0.0, + "total": 54.0, + "user": 0.0}, + {"cpu_number": 4, + "dpc": None, + "guest": 0.0, + "guest_nice": 0.0, + "idle": 34.0, + "interrupt": None, + "iowait": 2.0, + "irq": 0.0, + "key": "cpu_number", + "nice": 0.0, + "softirq": 0.0, + "steal": 0.0, + "system": 4.0, + "total": 66.0, + "user": 7.0}, + {"cpu_number": 5, "dpc": None, "guest": 0.0, "guest_nice": 0.0, @@ -1427,14 +1410,29 @@ Get plugin stats:: "nice": 0.0, "softirq": 0.0, "steal": 0.0, - "system": 0.0, + "system": 15.0, "total": 75.0, - "user": 1.0}, + "user": 6.0}, + {"cpu_number": 6, + "dpc": None, + "guest": 0.0, + "guest_nice": 0.0, + "idle": 42.0, + "interrupt": None, + "iowait": 1.0, + "irq": 0.0, + "key": "cpu_number", + "nice": 0.0, + "softirq": 0.0, + "steal": 0.0, + "system": 1.0, + "total": 58.0, + "user": 3.0}, {"cpu_number": 7, "dpc": None, "guest": 0.0, "guest_nice": 0.0, - "idle": 27.0, + "idle": 46.0, "interrupt": None, "iowait": 0.0, "irq": 0.0, @@ -1443,13 +1441,13 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 73.0, + "total": 54.0, "user": 0.0}, {"cpu_number": 8, "dpc": None, "guest": 0.0, "guest_nice": 0.0, - "idle": 26.0, + "idle": 45.0, "interrupt": None, "iowait": 0.0, "irq": 0.0, @@ -1458,13 +1456,13 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 74.0, - "user": 0.0}, + "total": 55.0, + "user": 2.0}, {"cpu_number": 9, "dpc": None, "guest": 0.0, "guest_nice": 0.0, - "idle": 26.0, + "idle": 47.0, "interrupt": None, "iowait": 0.0, "irq": 0.0, @@ -1473,28 +1471,13 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 74.0, + "total": 53.0, "user": 0.0}, {"cpu_number": 10, "dpc": None, "guest": 0.0, "guest_nice": 0.0, - "idle": 24.0, - "interrupt": None, - "iowait": 0.0, - "irq": 0.0, - "key": "cpu_number", - "nice": 0.0, - "softirq": 0.0, - "steal": 0.0, - "system": 1.0, - "total": 76.0, - "user": 2.0}, - {"cpu_number": 11, - "dpc": None, - "guest": 0.0, - "guest_nice": 0.0, - "idle": 26.0, + "idle": 46.0, "interrupt": None, "iowait": 0.0, "irq": 0.0, @@ -1503,13 +1486,28 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 74.0, + "total": 54.0, + "user": 0.0}, + {"cpu_number": 11, + "dpc": None, + "guest": 0.0, + "guest_nice": 0.0, + "idle": 46.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": 54.0, "user": 0.0}, {"cpu_number": 12, "dpc": None, "guest": 0.0, "guest_nice": 0.0, - "idle": 25.0, + "idle": 46.0, "interrupt": None, "iowait": 0.0, "irq": 0.0, @@ -1517,14 +1515,14 @@ Get plugin stats:: "nice": 0.0, "softirq": 0.0, "steal": 0.0, - "system": 1.0, - "total": 75.0, + "system": 0.0, + "total": 54.0, "user": 0.0}, {"cpu_number": 13, "dpc": None, "guest": 0.0, "guest_nice": 0.0, - "idle": 25.0, + "idle": 46.0, "interrupt": None, "iowait": 0.0, "irq": 0.0, @@ -1533,28 +1531,13 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 75.0, + "total": 54.0, "user": 0.0}, {"cpu_number": 14, "dpc": None, "guest": 0.0, "guest_nice": 0.0, - "idle": 26.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": 74.0, - "user": 1.0}, - {"cpu_number": 15, - "dpc": None, - "guest": 0.0, - "guest_nice": 0.0, - "idle": 26.0, + "idle": 45.0, "interrupt": None, "iowait": 0.0, "irq": 0.0, @@ -1563,9 +1546,24 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 1.0, - "total": 74.0, - "user": 0.0}], - "swap": 85.3} + "total": 55.0, + "user": 1.0}, + {"cpu_number": 15, + "dpc": None, + "guest": 0.0, + "guest_nice": 0.0, + "idle": 46.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": 54.0, + "user": 1.0}], + "swap": 85.9} Fields descriptions: @@ -1603,14 +1601,14 @@ Get plugin stats:: "label": "Ambient", "type": "temperature_core", "unit": "C", - "value": 46, + "value": 38, "warning": 0}, {"critical": None, "key": "label", "label": "Ambient 3", "type": "temperature_core", "unit": "C", - "value": 40, + "value": 33, "warning": 0}] Fields descriptions: @@ -1672,7 +1670,7 @@ Get a specific item when field matches the given value:: "label": "Ambient", "type": "temperature_core", "unit": "C", - "value": 46, + "value": 38, "warning": 0}]} GET smart @@ -1716,7 +1714,7 @@ GET uptime Get plugin stats:: # curl http://localhost:61208/api/4/uptime - "8 days, 1:07:15" + "8 days, 18:39:26" GET version ----------- @@ -1724,7 +1722,7 @@ GET version Get plugin stats:: # curl http://localhost:61208/api/4/version - "4.3.2_dev05" + "4.3.2_rc01" GET vms ------- @@ -1761,8 +1759,8 @@ Get plugin stats:: # curl http://localhost:61208/api/4/wifi [{"key": "ssid", - "quality_level": -69.0, - "quality_link": 41.0, + "quality_level": -54.0, + "quality_link": 56.0, "ssid": "wlp0s20f3"}] Get a specific field:: @@ -1774,8 +1772,8 @@ Get a specific item when field matches the given value:: # curl http://localhost:61208/api/4/wifi/ssid/value/wlp0s20f3 {"wlp0s20f3": [{"key": "ssid", - "quality_level": -69.0, - "quality_link": 41.0, + "quality_level": -54.0, + "quality_link": 56.0, "ssid": "wlp0s20f3"}]} GET all stats @@ -1839,34 +1837,34 @@ GET stats history History of a plugin:: # curl http://localhost:61208/api/4/cpu/history - {"system": [["2025-06-29T14:31:41.061193", 2.5], - ["2025-06-29T14:31:42.149752", 0.6], - ["2025-06-29T14:31:43.172681", 0.6]], - "user": [["2025-06-29T14:31:41.061192", 4.3], - ["2025-06-29T14:31:42.149751", 0.8], - ["2025-06-29T14:31:43.172679", 0.8]]} + {"system": [["2025-06-30T08:03:53.461336", 2.9], + ["2025-06-30T08:03:54.573558", 0.9], + ["2025-06-30T08:03:55.604110", 0.9]], + "user": [["2025-06-30T08:03:53.461333", 4.5], + ["2025-06-30T08:03:54.573555", 1.1], + ["2025-06-30T08:03:55.604107", 1.1]]} Limit history to last 2 values:: # curl http://localhost:61208/api/4/cpu/history/2 - {"system": [["2025-06-29T14:31:42.149752", 0.6], - ["2025-06-29T14:31:43.172681", 0.6]], - "user": [["2025-06-29T14:31:42.149751", 0.8], - ["2025-06-29T14:31:43.172679", 0.8]]} + {"system": [["2025-06-30T08:03:54.573558", 0.9], + ["2025-06-30T08:03:55.604110", 0.9]], + "user": [["2025-06-30T08:03:54.573555", 1.1], + ["2025-06-30T08:03:55.604107", 1.1]]} History for a specific field:: # curl http://localhost:61208/api/4/cpu/system/history - {"system": [["2025-06-29T14:31:39.957468", 2.5], - ["2025-06-29T14:31:41.061193", 2.5], - ["2025-06-29T14:31:42.149752", 0.6], - ["2025-06-29T14:31:43.172681", 0.6]]} + {"system": [["2025-06-30T08:03:52.275187", 2.9], + ["2025-06-30T08:03:53.461336", 2.9], + ["2025-06-30T08:03:54.573558", 0.9], + ["2025-06-30T08:03:55.604110", 0.9]]} Limit history for a specific field to last 2 values:: # curl http://localhost:61208/api/4/cpu/system/history - {"system": [["2025-06-29T14:31:42.149752", 0.6], - ["2025-06-29T14:31:43.172681", 0.6]]} + {"system": [["2025-06-30T08:03:54.573558", 0.9], + ["2025-06-30T08:03:55.604110", 0.9]]} GET limits (used for thresholds) -------------------------------- diff --git a/docs/man/glances.1 b/docs/man/glances.1 index 47c425f3..e9322d2f 100644 --- a/docs/man/glances.1 +++ b/docs/man/glances.1 @@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "GLANCES" "1" "Jun 29, 2025" "4.3.2_dev05" "Glances" +.TH "GLANCES" "1" "Jun 30, 2025" "4.3.2_rc01" "Glances" .SH NAME glances \- An eye on your system .SH SYNOPSIS