summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authornicolargo <nicolas@nicolargo.com>2022-09-24 19:03:04 +0200
committernicolargo <nicolas@nicolargo.com>2022-09-24 19:03:04 +0200
commitfee4696834ac389698ea9b019b127e98f0e07f19 (patch)
treea688e65995d972d9303396e294249238a0ff11d1
parentf0caf64837391d76602f7aa028f54102efb748cc (diff)
[DOC] Glances failed to start and some other issues - BSD #2106 (update doc)
Diffstat
-rw-r--r--docs/api.rst794
-rw-r--r--docs/man/glances.12
2 files changed, 679 insertions, 117 deletions
diff --git a/docs/api.rst b/docs/api.rst
index a43241f0..b498ccc4 100644
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -74,7 +74,7 @@ Get plugin stats::
"refresh": 3.0,
"regex": True,
"result": None,
- "timer": 0.8013665676116943},
+ "timer": 0.8387062549591064},
{"count": 0,
"countmax": 20.0,
"countmin": None,
@@ -83,7 +83,25 @@ Get plugin stats::
"refresh": 3.0,
"regex": True,
"result": None,
- "timer": 0.801210880279541}]
+ "timer": 0.8385326862335205}]
+
+Get a specific field::
+
+ # curl http://localhost:61208/api/3/amps/name
+ {"name": ["Dropbox", "Python", "Conntrack", "Nginx", "Systemd", "SystemV"]}
+
+Get a specific item when field matchs the given value::
+
+ # curl http://localhost:61208/api/3/amps/name/Dropbox
+ {"Dropbox": [{"count": 0,
+ "countmax": None,
+ "countmin": 1.0,
+ "key": "name",
+ "name": "Dropbox",
+ "refresh": 3.0,
+ "regex": True,
+ "result": None,
+ "timer": 0.8387062549591064}]}
GET core
--------
@@ -113,19 +131,19 @@ Get plugin stats::
"ctx_switches": 0,
"guest": 0.0,
"guest_nice": 0.0,
- "idle": 67.9,
+ "idle": 52.4,
"interrupts": 0,
- "iowait": 0.2,
+ "iowait": 2.5,
"irq": 0.0,
"nice": 0.0,
"soft_interrupts": 0,
"softirq": 0.2,
"steal": 0.0,
"syscalls": 0,
- "system": 5.3,
+ "system": 9.1,
"time_since_update": 1,
- "total": 33.3,
- "user": 26.4}
+ "total": 37.6,
+ "user": 35.8}
Fields descriptions:
@@ -133,6 +151,7 @@ Fields descriptions:
* **system**: percent time spent in kernel space. System CPU time is the time spent running code in the Operating System kernel (unit is *percent*)
* **user**: CPU percent time spent in user space. User CPU time is the time spent on the processor running your program's code (or code in libraries) (unit is *percent*)
* **iowait**: *(Linux)*: percent time spent by the CPU waiting for I/O operations to complete (unit is *percent*)
+* **dpc**: *(Windows)*: time spent servicing deferred procedure calls (DPCs) (unit is *percent*)
* **idle**: percent of CPU used by any program. Every program or task that runs on a computer system occupies a certain amount of processing time on the CPU. If the CPU has completed all tasks it is idle (unit is *percent*)
* **irq**: *(Linux and BSD)*: percent time spent servicing/handling hardware/software interrupts. Time servicing interrupts (hardware + software) (unit is *percent*)
* **nice**: *(Unix)*: percent time occupied by user level processes with a positive nice value. The time the CPU has spent running users' processes that have been *niced* (unit is *percent*)
@@ -147,7 +166,7 @@ Fields descriptions:
Get a specific field::
# curl http://localhost:61208/api/3/cpu/total
- {"total": 33.3}
+ {"total": 37.6}
GET diskio
----------
@@ -170,6 +189,57 @@ Get plugin stats::
"write_bytes": 0,
"write_count": 0}]
+Get a specific field::
+
+ # curl http://localhost:61208/api/3/diskio/disk_name
+ {"disk_name": ["sda", "sda1", "sda2", "sda5", "dm-0", "dm-1"]}
+
+Get a specific item when field matchs the given value::
+
+ # curl http://localhost:61208/api/3/diskio/disk_name/sda
+ {"sda": [{"disk_name": "sda",
+ "key": "disk_name",
+ "read_bytes": 0,
+ "read_count": 0,
+ "time_since_update": 1,
+ "write_bytes": 0,
+ "write_count": 0}]}
+
+GET docker
+----------
+
+Get plugin stats::
+
+ # curl http://localhost:61208/api/3/docker
+ [{"Command": ["/entrypoint.sh", "telegraf"],
+ "Id": "9230f84acadbb7bc8c087d0827389c9a87bb7c7022a1a299dcf4a5f3a441f1d3",
+ "Image": ["telegraf:latest"],
+ "Names": ["telegraf"],
+ "Status": "running",
+ "Uptime": "1 weeks",
+ "cpu_percent": 0.0,
+ "io_r": None,
+ "io_w": None,
+ "key": "name",
+ "memory_usage": 33148928,
+ "name": "telegraf",
+ "network_rx": None,
+ "network_tx": None},
+ {"Command": ["/run.sh"],
+ "Id": "09d96704c3e6b6cb21657d990e3c8ae1e44bac779ded141efb8fed899563dd66",
+ "Image": ["grafana/grafana:latest"],
+ "Names": ["grafana"],
+ "Status": "running",
+ "Uptime": "1 weeks",
+ "cpu_percent": 0.0,
+ "io_r": None,
+ "io_w": None,
+ "key": "name",
+ "memory_usage": None,
+ "name": "grafana",
+ "network_rx": None,
+ "network_tx": None}]
+
GET fs
------
@@ -177,13 +247,38 @@ Get plugin stats::
# curl http://localhost:61208/api/3/fs
[{"device_name": "/dev/mapper/ubuntu--gnome--vg-root",
- "free": 88879960064,
+ "free": 78089314304,
"fs_type": "ext4",
"key": "mnt_point",
"mnt_point": "/",
- "percent": 61.5,
+ "percent": 66.2,
"size": 243334156288,
- "used": 142066741248}]
+ "used": 152857387008},
+ {"device_name": "/dev/mapper/ubuntu--gnome--vg-root",
+ "free": 78089314304,
+ "fs_type": "ext4",
+ "key": "mnt_point",
+ "mnt_point": "/var/snap/firefox/common/host-hunspell",
+ "percent": 66.2,
+ "size": 243334156288,
+ "used": 152857387008}]
+
+Get a specific field::
+
+ # curl http://localhost:61208/api/3/fs/mnt_point
+ {"mnt_point": ["/", "/var/snap/firefox/common/host-hunspell"]}
+
+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": 78089314304,
+ "fs_type": "ext4",
+ "key": "mnt_point",
+ "mnt_point": "/",
+ "percent": 66.2,
+ "size": 243334156288,
+ "used": 152857387008}]}
GET ip
------
@@ -191,12 +286,11 @@ GET ip
Get plugin stats::
# curl http://localhost:61208/api/3/ip
- {"address": "192.168.0.48",
+ {"address": "192.168.0.32",
"gateway": "192.168.0.254",
"mask": "255.255.255.0",
"mask_cidr": 24,
- "public_address": "82.66.169.82",
- "public_info": "",
+ "public_address": "91.166.228.228",
"public_info_human": ""}
Get a specific field::
@@ -211,9 +305,9 @@ Get plugin stats::
# curl http://localhost:61208/api/3/load
{"cpucore": 4,
- "min1": 1.3974609375,
- "min15": 1.51318359375,
- "min5": 1.4091796875}
+ "min1": 1.12890625,
+ "min15": 1.07568359375,
+ "min5": 1.20458984375}
Fields descriptions:
@@ -225,7 +319,7 @@ Fields descriptions:
Get a specific field::
# curl http://localhost:61208/api/3/load/min1
- {"min1": 1.3974609375}
+ {"min1": 1.12890625}
GET mem
-------
@@ -233,16 +327,16 @@ GET mem
Get plugin stats::
# curl http://localhost:61208/api/3/mem
- {"active": 1351176192,
- "available": 3327692800,
- "buffers": 123637760,
- "cached": 1949274112,
- "free": 3327692800,
- "inactive": 3584765952,
- "percent": 57.5,
- "shared": 539725824,
+ {"active": 2355691520,
+ "available": 2727350272,
+ "buffers": 249974784,
+ "cached": 2882801664,
+ "free": 2727350272,
+ "inactive": 3822198784,
+ "percent": 65.2,
+ "shared": 569184256,
"total": 7836200960,
- "used": 4508508160}
+ "used": 5108850688}
Fields descriptions:
@@ -269,13 +363,13 @@ GET memswap
Get plugin stats::
# curl http://localhost:61208/api/3/memswap
- {"free": 7875063808,
- "percent": 2.6,
- "sin": 39329792,
- "sout": 242835456,
+ {"free": 3790909440,
+ "percent": 53.1,
+ "sin": 10184392704,
+ "sout": 16056197120,
"time_since_update": 1,
"total": 8082419712,
- "used": 207355904}
+ "used": 4291510272}
Fields descriptions:
@@ -299,9 +393,9 @@ Get plugin stats::
# curl http://localhost:61208/api/3/network
[{"alias": None,
- "cumulative_cx": 27815516,
- "cumulative_rx": 13907758,
- "cumulative_tx": 13907758,
+ "cumulative_cx": 547141210,
+ "cumulative_rx": 273570605,
+ "cumulative_tx": 273570605,
"cx": 2492,
"interface_name": "lo",
"is_up": True,
@@ -311,17 +405,17 @@ Get plugin stats::
"time_since_update": 1,
"tx": 1246},
{"alias": None,
- "cumulative_cx": 1788089656,
- "cumulative_rx": 1704639100,
- "cumulative_tx": 83450556,
- "cx": 26190,
+ "cumulative_cx": 9679745577,
+ "cumulative_rx": 9073526296,
+ "cumulative_tx": 606219281,
+ "cx": 21718,
"interface_name": "wlp2s0",
"is_up": True,
"key": "interface_name",
- "rx": 20229,
+ "rx": 15792,
"speed": 0,
"time_since_update": 1,
- "tx": 5961}]
+ "tx": 5926}]
Fields descriptions:
@@ -335,13 +429,44 @@ Fields descriptions:
* **is_up**: Is the interface up ? (unit is *bool*)
* **time_since_update**: Number of seconds since last update (unit is *seconds*)
+Get a specific field::
+
+ # curl http://localhost:61208/api/3/network/interface_name
+ {"interface_name": ["lo",
+ "wlp2s0",
+ "br-119e6ee04e05",
+ "br-87386b77b676",
+ "br_grafana",
+ "docker0",
+ "veth909d06e",
+ "veth9b67642",
+ "vethd7de7ad",
+ "vboxnet0",
+ "mpqemubr0"]}
+
+Get a specific item when field matchs the given value::
+
+ # curl http://localhost:61208/api/3/network/interface_name/lo
+ {"lo": [{"alias": None,
+ "cumulative_cx": 547141210,
+ "cumulative_rx": 273570605,
+ "cumulative_tx": 273570605,
+ "cx": 2492,
+ "interface_name": "lo",
+ "is_up": True,
+ "key": "interface_name",
+ "rx": 1246,
+ "speed": 0,
+ "time_since_update": 1,
+ "tx": 1246}]}
+
GET now
-------
Get plugin stats::
# curl http://localhost:61208/api/3/now
- "2022-09-03 10:54:47 CEST"
+ "2022-09-24 19:01:55 CEST"
GET percpu
----------
@@ -352,29 +477,34 @@ Get plugin stats::
[{"cpu_number": 0,
"guest": 0.0,
"guest_nice": 0.0,
- "idle": 74.0,
- "iowait": 1.0,
+ "idle": 31.0,
+ "iowait": 8.0,
"irq": 0.0,
"key": "cpu_number",
"nice": 0.0,
"softirq": 0.0,
"steal": 0.0,
- "system": 6.0,
- "total": 26.0,
- "user": 11.0},
+ "system": 8.0,
+ "total": 69.0,
+ "user": 50.0},
{"cpu_number": 1,
"guest": 0.0,
"guest_nice": 0.0,
- "idle": 79.0,
- "iowait": 0.0,
+ "idle": 51.0,
+ "iowait": 1.0,
"irq": 0.0,
"key": "cpu_number",
"nice": 0.0,
"softirq": 0.0,
"steal": 0.0,
- "system": 3.0,
- "total": 21.0,
- "user": 8.0}]
+ "system": 8.0,
+ "total": 49.0,
+ "user": 37.0}]
+
+Get a specific field::
+
+ # curl http://localhost:61208/api/3/percpu/cpu_number
+ {"cpu_number": [0, 1, 2, 3]}
GET ports
---------
@@ -388,21 +518,38 @@ Get plugin stats::
"port": 0,
"refresh": 30,
"rtt_warning": None,
- "status": 0.003824,
+ "status": 0.005664,
"timeout": 3}]
+Get a specific field::
+
+ # curl http://localhost:61208/api/3/ports/host
+ {"host": ["192.168.0.254"]}
+
+Get a specific item when field matchs the given value::
+
+ # curl http://localhost:61208/api/3/ports/host/192.168.0.254
+ {"192.168.0.254": [{"description": "DefaultGateway",
+ "host": "192.168.0.254",
+ "indice": "port_0",
+ "port": 0,
+ "refresh": 30,
+ "rtt_warning": None,
+ "status": 0.005664,
+ "timeout": 3}]}
+
GET processcount
----------------
Get plugin stats::
# curl http://localhost:61208/api/3/processcount
- {"pid_max": 0, "running": 1, "sleeping": 235, "thread": 1180, "total": 300}
+ {"pid_max": 0, "running": 3, "sleeping": 292, "thread": 1722, "total": 361}
Get a specific field::
# curl http://localhost:61208/api/3/processcount/total
- {"total": 300}
+ {"total": 361}
GET processlist
---------------
@@ -410,61 +557,452 @@ GET processlist
Get plugin stats::
# curl http://localhost:61208/api/3/processlist
- [{"cmdline": ["/snap/firefox/1794/usr/lib/firefox/firefox"],
+ [{"cmdline": ["/snap/firefox/1877/usr/lib/firefox/firefox"],
"cpu_percent": 0.0,
- "cpu_times": pcputimes(user=673.6, system=254.27, children_user=528.16, children_system=110.33, iowait=0.0),
+ "cpu_times": pcputimes(user=451.28, system=141.31, children_user=205.71, children_system=31.59, iowait=0.0),
"gids": pgids(real=1000, effective=1000, saved=1000),
- "io_counters": [556516352, 1268998144, 0, 0, 0],
+ "io_counters": [526351360, 531091456, 0, 0, 0],
"key": "pid",
- "memory_info": pmem(rss=476368896, vms=13038206976, shared=166002688, text=638976, lib=0, data=1025241088, dirty=0),
- "memory_percent": 6.079079625849718,
+ "memory_info": pmem(rss=450482176, vms=12297506816, shared=152215552, text=634880, lib=0, data=729407488, dirty=0),
+ "memory_percent": 5.748731793626692,
"name": "firefox",
"nice": 0,
- "num_threads": 124,
- "pid": 5486,
+ "num_threads": 121,
+ "pid": 477633,
"status": "S",
"time_since_update": 1,
"username": "nicolargo"},
- {"cmdline": ["/snap/firefox/1794/usr/lib/firefox/firefox",
+ {"cmdline": ["/snap/firefox/1877/usr/lib/firefox/firefox",
"-contentproc",
"-childID",
"1",
"-isForBrowser",
"-prefsLen",
- "30450",
+ "30507",
"-prefMapSize",
- "234720",
+ "235589",
"-jsInitLen",
- "247228",
+ "246848",
"-parentBuildID",
- "20220902081808",
+ "20220922230616",
"-appDir",
- "/snap/firefox/1794/usr/lib/firefox/browser",
- "5486",
+ "/snap/firefox/1877/usr/lib/firefox/browser",
+ "{6ceebb90-379f-4229-b8e3-37e0494c36c4}",
+ "477633",
"true",
"tab"],
"cpu_percent": 0.0,
- "cpu_times": pcputimes(user=67.47, system=12.2, children_user=0.0, children_system=0.0, iowait=0.0),
+ "cpu_times": pcputimes(user=77.7, system=13.75, children_user=0.0, children_system=0.0, iowait=0.0),
"gids": pgids(real=1000, effective=1000, saved=1000),
- "io_counters": [9496576, 0, 0, 0, 0],
+ "io_counters": [4724736, 0, 0, 0, 0],
"key": "pid",
- "memory_info": pmem(rss=408211456, vms=3241992192, shared=80101376, text=638976, lib=0, data=663171072, dirty=0),
- "memory_percent": 5.209303054933394,
+ "memory_info": pmem(rss=407302144, vms=3239350272, shared=82366464, text=634880, lib=0, data=641540096, dirty=0),
+ "memory_percent": 5.197699064624295,
"name": "WebExtensions",
"nice": 0,
- "num_threads": 20,
- "pid": 5730,
+ "num_threads": 22,
+ "pid": 477906,
"status": "S",
"time_since_update": 1,
"username": "nicolargo"}]
+Get a specific field::
+
+ # curl http://localhost:61208/api/3/processlist/pid
+ {"pid": [477633,
+ 477906,
+ 478013,
+ 4784,
+ 478017,
+ 371539,
+ 371076,
+ 371144,
+ 318967,
+ 8690,
+ 486802,
+ 484335,
+ 488179,
+ 378577,
+ 477924,
+ 174274,
+ 488541,
+ 371161,
+ 371008,
+ 488573,
+ 488854,
+ 488677,
+ 7012,
+ 27079,
+ 371044,
+ 138155,
+ 385575,
+ 488841,
+ 5288,
+ 2173,
+ 451763,
+ 231559,
+ 371369,
+ 477843,
+ 478972,
+ 396952,
+ 86902,
+ 488833,
+ 4677,
+ 479017,
+ 378578,
+ 231684,
+ 294867,
+ 488868,
+ 231727,
+ 343,
+ 454839,
+ 451764,
+ 385601,
+ 371175,
+ 2410,
+ 306104,
+ 57024,
+ 364779,
+ 143873,
+ 371055,
+ 385574,
+ 4882,
+ 371492,
+ 27101,
+ 487714,
+ 8716,
+ 445656,
+ 4980,
+ 1234,
+ 174164,
+ 1,
+ 4592,
+ 9030,
+ 6654,
+ 4955,
+ 4950,
+ 4850,
+ 5060,
+ 8974,
+ 8689,
+ 174166,
+ 8896,
+ 4859,
+ 1283,
+ 1282,
+ 4581,
+ 5295,
+ 1255,
+ 4954,
+ 371013,
+ 4608,
+ 5151,
+ 8633,
+ 4868,
+ 21750,
+ 5075,
+ 4600,
+ 5774,
+ 4562,
+ 27046,
+ 21749,
+ 9249,
+ 294892,
+ 4762,
+ 4963,
+ 12787,
+ 371014,
+ 2894,
+ 9250,
+ 1430,
+ 4894,
+ 459894,
+ 4770,
+ 231540,
+ 1387,
+ 13199,
+ 7033,
+ 290593,
+ 5320,
+ 4953,
+ 13659,
+ 5031,
+ 1233,
+ 4985,
+ 231642,
+ 5132,
+ 231697,
+ 1883,
+ 4956,
+ 13217,
+ 4814,
+ 1080,
+ 8648,
+ 1431,
+ 4958,
+ 5078,
+ 290540,
+ 4901,
+ 1278,
+ 1216,
+ 1893,
+ 371324,
+ 4864,
+ 1229,
+ 5044,
+ 2107,
+ 4833,
+ 1242,
+ 4949,
+ 4952,
+ 2334,
+ 2370,
+ 27078,
+ 4809,
+ 1251,
+ 4822,
+ 8584,
+ 4610,
+ 4678,
+ 5054,
+ 4787,
+ 8583,
+ 4951,
+ 1277,
+ 5085,
+ 5160,
+ 1256,
+ 4972,
+ 4615,
+ 4938,
+ 388,
+ 7265,
+ 4683,
+ 294886,
+ 8600,
+ 4796,
+ 4848,
+ 4970,
+ 1225,
+ 488805,
+ 60479,
+ 4803,
+ 1244,
+ 4957,
+ 4795,
+ 8936,
+ 1260,
+ 1264,
+ 174259,
+ 4749,
+ 1445,
+ 371029,
+ 98466,
+ 1232,
+ 8860,
+ 1613,
+ 4589,
+ 1077,
+ 1285,
+ 5176,
+ 2897,
+ 1081,
+ 2112,
+ 2154,
+ 71513,
+ 4590,
+ 2131,
+ 1088,
+ 2367,
+ 1090,
+ 1228,
+ 2368,
+ 371016,
+ 1217,
+ 488840,
+ 1949,
+ 8586,
+ 4948,
+ 2125,
+ 231626,
+ 231453,
+ 231471,
+ 231611,
+ 4654,
+ 227172,
+ 231459,
+ 231492,
+ 231514,
+ 231500,
+ 231478,
+ 4582,
+ 231522,
+ 5403,
+ 2124,
+ 1289,
+ 445844,
+ 2,
+ 3,
+ 4,
+ 5,
+ 7,
+ 10,
+ 11,
+ 12,
+ 13,
+ 14,
+ 15,
+ 16,
+ 17,
+ 18,
+ 19,
+ 20,
+ 21,
+ 23,
+ 24,
+ 25,
+ 26,
+ 27,
+ 29,
+ 30,
+ 31,
+ 32,
+ 33,
+ 35,
+ 36,
+ 37,
+ 38,
+ 39,
+ 40,
+ 41,
+ 42,
+ 43,
+ 44,
+ 91,
+ 92,
+ 93,
+ 95,
+ 96,
+ 97,
+ 98,
+ 99,
+ 100,
+ 102,
+ 105,
+ 106,
+ 108,
+ 109,
+ 111,
+ 116,
+ 117,
+ 118,
+ 128,
+ 131,
+ 137,
+ 171,
+ 173,
+ 189,
+ 196,
+ 197,
+ 198,
+ 201,
+ 202,
+ 203,
+ 204,
+ 205,
+ 209,
+ 210,
+ 215,
+ 216,
+ 233,
+ 281,
+ 282,
+ 370,
+ 371,
+ 389,
+ 507,
+ 549,
+ 570,
+ 571,
+ 572,
+ 573,
+ 803,
+ 804,
+ 805,
+ 806,
+ 807,
+ 808,
+ 809,
+ 810,
+ 811,
+ 812,
+ 813,
+ 814,
+ 2146,
+ 2205,
+ 2225,
+ 2286,
+ 2289,
+ 2290,
+ 2291,
+ 2293,
+ 2295,
+ 2296,
+ 2297,
+ 4847,
+ 8614,
+ 295453,
+ 463540,
+ 486333,
+ 486502,
+ 486568,
+ 487115,
+ 487502,
+ 487592,
+ 487598,
+ 487600,
+ 487601,
+ 487605,
+ 487606,
+ 487631,
+ 487632,
+ 487635,
+ 487655,
+ 487659,
+ 488819]}
+
+Get a specific item when field matchs the given value::
+
+ # curl http://localhost:61208/api/3/processlist/pid/477633
+ {"477633": [{"cmdline": ["/snap/firefox/1877/usr/lib/firefox/firefox"],
+ "cpu_percent": 0.0,
+ "cpu_times": [451.28, 141.31, 205.71, 31.59, 0.0],
+ "gids": [1000, 1000, 1000],
+ "io_counters": [526351360, 531091456, 0, 0, 0],
+ "key": "pid",
+ "memory_info": [450482176,
+ 12297506816,
+ 152215552,
+ 634880,
+ 0,
+ 729407488,
+ 0],
+ "memory_percent": 5.748731793626692,
+ "name": "firefox",
+ "nice": 0,
+ "num_threads": 121,
+ "pid": 477633,
+ "status": "S",
+ "time_since_update": 1,
+ "username": "nicolargo"}]}
+
GET psutilversion
-----------------
Get plugin stats::
# curl http://localhost:61208/api/3/psutilversion
- (5, 9, 1)
+ (5, 9, 2)
GET quicklook
-------------
@@ -472,69 +1010,69 @@ GET quicklook
Get plugin stats::
# curl http://localhost:61208/api/3/quicklook
- {"cpu": 33.3,
+ {"cpu": 37.6,
"cpu_hz": 3000000000.0,
- "cpu_hz_current": 1292446000.0000002,
+ "cpu_hz_current": 2549363750.0,
"cpu_name": "Intel(R) Core(TM) i7-4500U CPU @ 1.80GHz",
- "mem": 57.5,
+ "mem": 65.2,
"percpu": [{"cpu_number": 0,
"guest": 0.0,
"guest_nice": 0.0,
- "idle": 74.0,
- "iowait": 1.0,
+ "idle": 31.0,
+ "iowait": 8.0,
"irq": 0.0,
"key": "cpu_number",
"nice": 0.0,
"softirq": 0.0,
"steal": 0.0,
- "system": 6.0,
- "total": 26.0,
- "user": 11.0},
+ "system": 8.0,
+ "total": 69.0,
+ "user": 50.0},
{"cpu_number": 1,
"guest": 0.0,
"guest_nice": 0.0,
- "idle": 79.0,
- "iowait": 0.0,
+ "idle": 51.0,
+ "iowait": 1.0,
"irq": 0.0,
"key": "cpu_number",
"nice": 0.0,
"softirq": 0.0,
"steal": 0.0,
- "system": 3.0,
- "total": 21.0,
- "user": 8.0},
+ "system": 8.0,
+ "total": 49.0,
+ "user": 37.0},
{"cpu_number": 2,
"guest": 0.0,
"guest_nice": 0.0,
- "idle": 62.0,
+ "idle": 80.0,
"iowait": 0.0,
"irq": 0.0,
"key": "cpu_number",
"nice": 0.0,
"softirq": 0.0,
"steal": 0.0,
- "system": 4.0,
- "total": 38.0,
- "user": 25.0},
+ "system": 5.0,
+ "total": 20.0,
+ "user": 9.0},
{"cpu_number": 3,
"guest": 0.0,
"guest_nice": 0.0,
- "idle": 27.0,
- "iowait": 0.0,
+ "idle": 69.0,
+ "iowait": 1.0,
"irq": 0.0,
"key": "cpu_number",
"nice": 0.0,
"softirq": 0.0,
"steal": 0.0,
- "system": 3.0,
- "total": 73.0,
- "user": 61.0}],
- "swap": 2.6}
+ "system": 8.0,
+ "total": 31.0,
+ "user": 20.0}],
+ "swap": 53.1}
Get a specific field::
# curl http://localhost:61208/api/3/quicklook/cpu
- {"cpu": 33.3}
+ {"cpu": 37.6}
GET sensors
-----------
@@ -557,6 +1095,30 @@ Get plugin stats::
"value": 29,
"warning": 105}]
+Get a specific field::
+
+ # curl http://localhost:61208/api/3/sensors/label
+ {"label": ["acpitz 1",
+ "acpitz 2",
+ "Package id 0",
+ "Core 0",
+ "Core 1",
+ "CPU",
+ "Ambient",
+ "SODIMM",
+ "BAT BAT0"]}
+
+Get a specific item when field matchs the given value::
+
+ # curl http://localhost:61208/api/3/sensors/label/acpitz 1
+ {"acpitz 1": [{"critical": 105,
+ "key": "label",
+ "label": "acpitz 1",
+ "type": "temperature_core",
+ "unit": "C",
+ "value": 27,
+ "warning": 105}]}
+
GET system
----------
@@ -581,7 +1143,7 @@ GET uptime
Get plugin stats::
# curl http://localhost:61208/api/3/uptime
- {"seconds": 5931}
+ {"seconds": 1849550}
GET all stats
-------------
@@ -597,33 +1159,33 @@ GET stats history
History of a plugin::
# curl http://localhost:61208/api/3/cpu/history
- {"system": [["2022-09-03T10:54:47.761857", 5.3],
- ["2022-09-03T10:54:48.797383", 5.3],
- ["2022-09-03T10:54:49.871164", 7.5]],
- "user": [["2022-09-03T10:54:47.761852", 26.4],
- ["2022-09-03T10:54:48.797373", 26.4],
- ["2022-09-03T10:54:49.871160", 23.4]]}
+ {"system": [["2022-09-24T19:01:56.588010", 9.1],
+ ["2022-09-24T19:01:57.677626", 9.1],
+ ["2022-09-24T19:01:58.852745", 6.0]],
+ "user": [["2022-09-24T19:01:56.588000", 35.8],
+ ["2022-09-24T19:01:57.677620", 35.8],
+ ["2022-09-24T19:01:58.852740", 42.2]]}
Limit history to last 2 values::
# curl http://localhost:61208/api/3/cpu/history/2
- {"system": [["2022-09-03T10:54:48.797383", 5.3],
- ["2022-09-03T10:54:49.871164", 7.5]],
- "user": [["2022-09-03T10:54:48.797373", 26.4],
- ["2022-09-03T10:54:49.871160", 23.4]]}
+ {"system": [["2022-09-24T19:01:57.677626", 9.1],
+ ["2022-09-24T19:01:58.852745", 6.0]],
+ "user": [["2022-09-24T19:01:57.677620", 35.8],
+ ["2022-09-24T19:01:58.852740", 42.2]]}
History for a specific field::
# curl http://localhost:61208/api/3/cpu/system/history
- {"system": [["2022-09-03T10:54:47.761857", 5.3],
- ["2022-09-03T10:54:48.797383", 5.3],
- ["2022-09-03T10:54:49.871164", 7.5]]}
+ {"system": [["2022-09-24T19:01:56.588010", 9.1],
+ ["2022-09-24T19:01:57.677626", 9.1],
+ ["2022-09-24T19:01:58.852745", 6.0]]}
Limit history for a specific field to last 2 values::
# curl http://localhost:61208/api/3/cpu/system/history
- {"system": [["2022-09-03T10:54:48.797383", 5.3],
- ["2022-09-03T10:54:49.871164", 7.5]]}
+ {"system": [["2022-09-24T19:01:57.677626", 9.1],
+ ["2022-09-24T19:01:58.852745", 6.0]]}
GET limits (used for thresholds)
--------------------------------
diff --git a/docs/man/glances.1 b/docs/man/glances.1
index 5944cdfb..1d725d24 100644
--- a/docs/man/glances.1
+++ b/docs/man/glances.1
@@ -27,7 +27,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" "Sep 03, 2022" "3.3.0_beta1" "Glances"
+.TH "GLANCES" "1" "Sep 24, 2022" "3.3.0_beta1" "Glances"
.SH NAME
glances \- An eye on