summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authornicolargo <nicolas@nicolargo.com>2023-05-13 10:47:29 +0200
committernicolargo <nicolas@nicolargo.com>2023-05-13 10:47:29 +0200
commite8daa49eeae92cd33b754958b482926a4ec399b8 (patch)
tree4a70f758c598e157de22c85b800c8a0050f104e9
parentb43eecf83e99d10be2f470847ee2d209437cb0ce (diff)
Glances 3.4.0 Release Candidate 1 (RC1)
Diffstat
-rw-r--r--README.rst3
-rw-r--r--docs/api.rst1380
-rw-r--r--docs/docker.rst6
-rw-r--r--glances/__init__.py2
-rw-r--r--glances/outputs/static/package-lock.json322
-rw-r--r--glances/outputs/static/package.json2
6 files changed, 1545 insertions, 170 deletions
diff --git a/README.rst b/README.rst
index fa822e90..47ec0006 100644
--- a/README.rst
+++ b/README.rst
@@ -248,6 +248,8 @@ Run the container in *Web server mode*:
docker run -d --restart="always" -p 61208-61209:61208-61209 -e TZ="${TZ}" -e GLANCES_OPT="-w" -v /var/run/docker.sock:/var/run/docker.sock:ro --pid host nicolargo/glances:latest-full
+For a full list of options, see the Glances `Docker`_ documentation page.
+
GNU/Linux
---------
@@ -483,3 +485,4 @@ Glances is distributed under the LGPL version 3 license. See ``COPYING`` for mor
.. _wishlist: https://www.amazon.fr/hz/wishlist/ls/BWAAQKWFR3FI?ref_=wl_share
.. _issue2021: https://github.com/nicolargo/glances/issues/2021#issuecomment-1197831157
.. _issue2021comment: https://github.com/nicolargo/glances/issues/2021#issuecomment-1197831157
+.. _Docker: https://github.com/nicolargo/glances/blob/develop/docs/docker.rst
diff --git a/docs/api.rst b/docs/api.rst
index 2566c354..e09c866c 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
- [[1683529666.0,
+ [[1683966001.0,
-1,
"WARNING",
"MEM",
- 72.14659297257798,
- 72.14659297257798,
- 72.14659297257798,
- 72.14659297257798,
+ 72.50695326143375,
+ 72.50695326143375,
+ 72.50695326143375,
+ 72.50695326143375,
1,
[],
"",
@@ -93,7 +93,7 @@ Get plugin stats::
"refresh": 3.0,
"regex": True,
"result": None,
- "timer": 1.4009511470794678},
+ "timer": 0.8150734901428223},
{"count": 0,
"countmax": 20.0,
"countmin": None,
@@ -102,7 +102,7 @@ Get plugin stats::
"refresh": 3.0,
"regex": True,
"result": None,
- "timer": 1.4008433818817139}]
+ "timer": 0.8149070739746094}]
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": 1.4009511470794678}]}
+ "timer": 0.8150734901428223}]}
GET connections
---------------
@@ -141,3 +141,1367 @@ GET containers
Get plugin stats::
# curl http://localhost:61208/api/3/containers
+ {"containers": [{"Command": ["top"],
+ "Created": "2023-05-08T15:29:34.918692365+02:00",
+ "Id": "4b7f732d43e4bc5d92fe5298cba025b550e6a608754c1c38f9a90aaecd46b8f9",
+ "Image": "["docker.io/library/ubuntu:latest"]",
+ "Status": "running",
+ "Uptime": "4 days",
+ "cpu": {"total": 2.7540959823779166e-07},
+ "cpu_percent": 2.7540959823779166e-07,
+ "engine": "podman",
+ "io": {"ior": 0.0, "iow": 0.0, "time_since_update": 1},
+ "io_r": 0.0,
+ "io_w": 0.0,
+ "key": "name",
+ "memory": {"limit": 7836184576.0, "usage": 2289664.0},
+ "memory_usage": 2289664.0,
+ "name": "frosty_bouman",
+ "network": {"rx": 0.0, "time_since_update": 1, "tx": 0.0},
+ "network_rx": 0.0,
+ "network_tx": 0.0,
+ "pod_id": "8d0f1c783def",
+ "pod_name": "frosty_bouman"},
+ {"Command": [],
+ "Created": "2022-10-22T14:23:03.120912374+02:00",
+ "Id": "9491515251edcd5bb5dc17205d7ee573c0be96fe0b08b0a12a7e2cea874565ea",
+ "Image": "["k8s.gcr.io/pause:3.5"]",
+ "Status": "running",
+ "Uptime": "4 days",
+ "cpu": {"total": 2.497081292340971e-10},
+ "cpu_percent": 2.497081292340971e-10,
+ "engine": "podman",
+ "io": {"ior": 0.0, "iow": 0.0, "time_since_update": 1},
+ "io_r": 0.0,
+ "io_w": 0.0,
+ "key": "name",
+ "memory": {"limit": 7836184576.0, "usage": 671744.0},
+ "memory_usage": 671744.0,
+ "name": "8d0f1c783def-infra",
+ "network": {"rx": 0.0, "time_since_update": 1, "tx": 0.0},
+ "network_rx": 0.0,
+ "network_tx": 0.0,
+ "pod_id": "8d0f1c783def",
+ "pod_name": "8d0f1c783def-infra"},
+ {"Command": ["/portainer"],
+ "Created": "2022-10-29T14:59:10.266701439Z",
+ "Id": "3abd51c615968482d9ccff5afc629f267f6dda113ed68b75b432615fae3b49fb",
+ "Image": ["portainer/portainer-ce:2.9.3"],
+ "Status": "running",
+ "Uptime": "56 mins",
+ "cpu": {"total": 0.0},
+ "cpu_percent": 0.0,
+ "engine": "docker",
+ "io": {},
+ "io_r": None,
+ "io_w": None,
+ "key": "name",
+ "memory": {},
+ "memory_usage": None,
+ "name": "portainer",
+ "network": {},
+ "network_rx": None,
+ "network_tx": None}],
+ "version": {},
+ "version_podman": {}}
+
+GET core
+--------
+
+Get plugin stats::
+
+ # curl http://localhost:61208/api/3/core
+ {"log": 4, "phys": 2}
+
+Fields descriptions:
+
+* **phys**: Number of physical cores (hyper thread CPUs are excluded) (unit is *number*)
+* **log**: Number of logical CPUs. A logical CPU is the number of physical cores multiplied by the number of threads that can run on each core (unit is *number*)
+
+Get a specific field::
+
+ # curl http://localhost:61208/api/3/core/phys
+ {"phys": 2}
+
+GET cpu
+-------
+
+Get plugin stats::
+
+ # curl http://localhost:61208/api/3/cpu
+ {"cpucore": 4,
+ "ctx_switches": 0,
+ "guest": 0.0,
+ "guest_nice": 0.0,
+ "idle": 68.2,
+ "interrupts": 0,
+ "iowait": 0.0,
+ "irq": 0.0,
+ "nice": 0.0,
+ "soft_interrupts": 0,
+ "softirq": 0.0,
+ "steal": 0.0,
+ "syscalls": 0,
+ "system": 4.3,
+ "time_since_update": 1,
+ "total": 33.6,
+ "user": 27.6}
+
+Fields descriptions:
+
+* **total**: Sum of all CPU percentages (except idle) (unit is *percent*)
+* **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*)
+* **steal**: *(Linux)*: percentage of time a virtual CPU waits for a real CPU while the hypervisor is servicing another virtual processor (unit is *percent*)
+* **ctx_switches**: number of context switches (voluntary + involuntary) per second. A context switch is a procedure that a computer's CPU (central processing unit) follows to change from one task (or process) to another while ensuring that the tasks do not conflict (unit is *number*)
+* **interrupts**: number of interrupts per second (unit is *number*)
+* **soft_interrupts**: number of software interrupts per second. Always set to 0 on Windows and SunOS (unit is *number*)
+* **syscalls**: number of system calls per second. Always 0 on Linux OS (unit is *number*)
+* **cpucore**: Total number of CPU core (unit is *number*)
+* **time_since_update**: Number of seconds since last update (unit is *seconds*)
+
+Get a specific field::
+
+ # curl http://localhost:61208/api/3/cpu/total
+ {"total": 33.6}
+
+GET diskio
+----------
+
+Get plugin stats::
+
+ # curl http://localhost:61208/api/3/diskio
+ [{"disk_name": "sda",
+ "key": "disk_name",
+ "read_bytes": 0,
+ "read_count": 0,
+ "time_since_update": 1,
+ "write_bytes": 0,
+ "write_count": 0},
+ {"disk_name": "sda1",
+ "key": "disk_name",
+ "read_bytes": 0,
+ "read_count": 0,
+ "time_since_update": 1,
+ "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 fs
+------
+
+Get plugin stats::
+
+ # curl http://localhost:61208/api/3/fs
+ [{"device_name": "/dev/mapper/ubuntu--gnome--vg-root",
+ "free": 9130688512,
+ "fs_type": "ext4",
+ "key": "mnt_point",
+ "mnt_point": "/",
+ "percent": 96.0,
+ "size": 243334156288,
+ "used": 221816012800},
+ {"device_name": "zsfpool",
+ "free": 41811968,
+ "fs_type": "zfs",
+ "key": "mnt_point",
+ "mnt_point": "/zsfpool",
+ "percent": 0.3,
+ "size": 41943040,
+ "used": 131072}]
+
+Get a specific field::
+
+ # curl http://localhost:61208/api/3/fs/mnt_point
+ {"mnt_point": ["/", "/zsfpool", "/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": 9130688512,
+ "fs_type": "ext4",
+ "key": "mnt_point",
+ "mnt_point": "/",
+ "percent": 96.0,
+ "size": 243334156288,
+ "used": 221816012800}]}
+
+GET ip
+------
+
+Get plugin stats::
+
+ # curl http://localhost:61208/api/3/ip
+ {"address": "192.168.0.32",
+ "gateway": "192.168.0.254",
+ "mask": "255.255.255.0",
+ "mask_cidr": 24,
+ "public_address": "91.166.228.228",
+ "public_info_human": ""}
+
+Get a specific field::
+
+ # curl http://localhost:61208/api/3/ip/gateway
+ {"gateway": "192.168.0.254"}
+
+GET load
+--------
+
+Get plugin stats::
+
+ # curl http://localhost:61208/api/3/load
+ {"cpucore": 4,
+ "min1": 1.02783203125,
+ "min15": 0.9677734375,
+ "min5": 0.92041015625}
+
+Fields descriptions:
+
+* **min1**: Average sum of the number of processes waiting in the run-queue plus the number currently executing over 1 minute (unit is *float*)
+* **min5**: Average sum of the number of processes waiting in the run-queue plus the number currently executing over 5 minutes (unit is *float*)
+* **min15**: Average sum of the number of processes waiting in the run-queue plus the number currently executing over 15 minutes (unit is *float*)
+* **cpucore**: Total number of CPU core (unit is *number*)
+
+Get a specific field::
+
+ # curl http://localhost:61208/api/3/load/min1
+ {"min1": 1.02783203125}
+
+GET mem
+-------
+
+Get plugin stats::
+
+ # curl http://localhost:61208/api/3/mem
+ {"active": 2569023488,
+ "available": 2154405888,
+ "buffers": 287842304,
+ "cached": 2519867392,
+ "free": 2154405888,
+ "inactive": 3937296384,
+ "percent": 72.5,
+ "shared": 520912896,
+ "total": 7836184576,
+ "used": 5681778688}
+
+Fields descriptions:
+
+* **total**: Total physical memory available (unit is *bytes*)
+* **available**: The actual amount of available memory that can be given instantly to processes that request more memory in bytes; this is calculated by summing different memory values depending on the platform (e.g. free + buffers + cached on Linux) and it is supposed to be used to monitor actual memory usage in a cross platform fashion (unit is *bytes*)
+* **percent**: The percentage usage calculated as (total - available) / total * 100 (unit is *percent*)
+* **used**: Memory used, calculated differently depending on the platform and designed for informational purposes only (unit is *bytes*)
+* **free**: Memory not being used at all (zeroed) that is readily available; note that this doesn't reflect the actual memory available (use 'available' instead) (unit is *bytes*)
+* **active**: *(UNIX)*: memory currently in use or very recently used, and so it is in RAM (unit is *bytes*)
+* **inactive**: *(UNIX)*: memory that is marked as not used (unit is *bytes*)
+* **buffers**: *(Linux, BSD)*: cache for things like file system metadata (unit is *bytes*)
+* **cached**: *(Linux, BSD)*: cache for various things (unit is *bytes*)
+* **wired**: *(BSD, macOS)*: memory that is marked to always stay in RAM. It is never moved to disk (unit is *bytes*)
+* **shared**: *(BSD)*: memory that may be simultaneously accessed by multiple processes (unit is *bytes*)
+
+Get a specific field::
+
+ # curl http://localhost:61208/api/3/mem/total
+ {"total": 7836184576}
+
+GET memswap
+-----------
+
+Get plugin stats::
+
+ # curl http://localhost:61208/api/3/memswap
+ {"free": 7106760704,
+ "percent": 12.1,
+ "sin": 290373632,
+ "sout": 1480765440,
+ "time_since_update": 1,
+ "total": 8082419712,
+ "used": 975659008}
+
+Fields descriptions:
+
+* **total**: Total swap memory (unit is *bytes*)
+* **used**: Used swap memory (unit is *bytes*)
+* **free**: Free swap memory (unit is *bytes*)
+* **percent**: Used swap memory in percentage (unit is *percent*)
+* **sin**: The number of bytes the system has swapped in from disk (cumulative) (unit is *bytes*)
+* **sout**: The number of bytes the system has swapped out from disk (cumulative) (unit is *bytes*)
+* **time_since_update**: Number of seconds since last update (unit is *seconds*)
+
+Get a specific field::
+
+ # curl http://localhost:61208/api/3/memswap/total
+ {"total": 8082419712}
+
+GET network
+-----------
+
+Get plugin stats::
+
+ # curl http://localhost:61208/api/3/network
+ [{"alias": None,
+ "cumulative_cx": 49269114,
+ "cumulative_rx": 24634557,
+ "cumulative_tx": 24634557,
+ "cx": 2354,
+ "interface_name": "lo",
+ "is_up": True,
+ "key": "interface_name",
+ "rx": 1177,
+ "speed": 0,
+ "time_since_update": 1,
+ "tx": 1177},
+ {"alias": None,
+ "cumulative_cx": 3174346554,
+ "cumulative_rx": 3052552104,
+ "cumulative_tx": 121794450,
+ "cx": 32826,
+ "interface_name": "wlp2s0",
+ "is_up": True,
+ "key": "interface_name",
+ "rx": 24521,
+ "speed": 0,
+ "time_since_update": 1,
+ "tx": 8305}]
+
+Fields descriptions:
+
+* **interface_name**: Interface name (unit is *string*)
+* **alias**: Interface alias name (optional) (unit is *string*)
+* **rx**: The received/input rate (in bit per second) (unit is *bps*)
+* **tx**: The sent/output rate (in bit per second) (unit is *bps*)
+* **cx**: The cumulative received+sent rate (in bit per second) (unit is *bps*)
+* **cumulative_rx**: The number of bytes received through the interface (cumulative) (unit is *bytes*)
+* **cumulative_tx**: The number of bytes sent through the interface (cumulative) (unit is *bytes*)
+* **cumulative_cx**: The cumulative number of bytes reveived and sent through the interface (cumulative) (unit is *bytes*)
+* **speed**: Maximum interface speed (in bit per second). Can return 0 on some operating-system (unit is *bps*)
+* **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",
+ "docker0",
+ "br_grafana",
+ "mpqemubr0",
+ "vethcddb0e6"]}
+
+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": 49269114,
+ "cumulative_rx": 24634557,
+ "cumulative_tx": 24634557,
+ "cx": 2354,
+ "interface_name": "lo",
+ "is_up": True,
+ "key": "interface_name",
+ "rx": 1177,
+ "speed": 0,
+ "time_since_update": 1,
+ "tx": 1177}]}
+
+GET now
+-------
+
+Get plugin stats::
+
+ # curl http://localhost:61208/api/3/now
+ "2023-05-13 10:20:00 CEST"
+
+GET percpu
+----------
+
+Get plugin stats::
+
+ # curl http://localhost:61208/api/3/percpu
+ [{"cpu_number": 0,
+ "guest": 0.0,
+ "guest_nice": 0.0,
+ "idle": 77.0,
+ "iowait": 0.0,
+ "irq": 0.0,
+ "key": "cpu_number",
+ "nice": 0.0,
+ "softirq": 0.0,
+ "steal": 0.0,
+ "system": 3.0,
+ "total": 23.0,
+ "user": 20.0},
+ {"cpu_number": 1,
+ "guest": 0.0,
+ "guest_nice": 0.0,
+ "idle": 56.0,
+ "iowait": 0.0,
+ "irq": 0.0,
+ "key": "cpu_number",
+ "nice": 0.0,
+ "softirq": 0.0,
+ "steal": 0.0,
+ "system": 4.0,
+ "total": 44.0,
+ "user": 38.0}]
+
+Get a specific field::
+
+ # curl http://localhost:61208/api/3/percpu/cpu_number
+ {"cpu_number": [0, 1, 2, 3]}
+
+GET ports
+---------
+
+Get plugin stats::
+
+ # curl http://localhost:61208/api/3/ports
+ [{"description": "DefaultGateway",
+ "host": "192.168.0.254",
+ "indice": "port_0",
+ "port": 0,
+ "refresh": 30,
+ "rtt_warning": None,
+ "status": 0.006516,
+ "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.006516,
+ "timeout": 3}]}
+
+GET processcount
+----------------
+
+Get plugin stats::
+
+ # curl http://localhost:61208/api/3/processcount
+ {"pid_max": 0, "running": 1, "sleeping": 313, "thread": 1532, "total": 378}
+
+Get a specific field::
+
+ # curl http://localhost:61208/api/3/processcount/total
+ {"total": 378}
+
+GET processlist
+---------------
+
+Get plugin stats::
+
+ # curl http://localhost:61208/api/3/processlist
+ [{"cmdline": ["/snap/firefox/2605/usr/lib/firefox/firefox",
+ "-contentproc",
+ "-childID",
+ "6",
+ "-isForBrowser",
+ "-prefsLen",
+ "38436",
+ "-prefMapSize",
+ "241898",
+ "-jsInitLen",
+ "240056",
+ "-parentBuildID",
+ "20230424185118",
+ "-appDir",
+ "/snap/firefox/2605/usr/lib/firefox/browser",
+ "{c94b5dea-52c6-4c75-a314-5de48bda9cdc}",
+ "10541",
+ "true",
+ "tab"],
+ "cpu_percent": 0.0,
+ "cpu_times": [357.9, 40.31, 0.0, 0.0, 0.0],
+ "gids": [1000, 1000, 1000],
+ "io_counters": [22819840, 0, 0, 0, 0],
+ "key": "pid",
+ "memory_info": [473870336, 3517755392, 86867968, 618496, 0, 924098560, 0],
+ "memory_percent": 6.047207431169115,
+ "name": "WebExtensions",
+ "nice": 0,
+ "num_threads": 20,
+ "pid": 11043,
+ "status": "S",
+ "time_since_update": 1,
+ "username": "nicolargo"},
+ {"cmdline": ["/usr/share/code/code",
+ "--ms-enable-electron-run-as-node",
+ "/home/nicolargo/.vscode/extensions/ms-python.vscode-pylance-2023.5.10/dist/server.bundle.js",
+ "--cancellationReceive=file:a45d0addfc80b8027622ae0652ef4d4c3a3d754b26",
+ "--node-ipc",
+ "--clientProcessId=59454"],
+ "cpu_percent": 0.0,
+ "cpu_times": [89.73, 7.11, 0.61, 0.16, 0.0],
+ "gids": [1000, 1000, 1000],
+ "io_counters": [55275520, 0, 0, 0, 0],
+ "key": "pid",
+ "memory_info": [468602880,
+ 1205610397696,
+ 43884544,
+ 118128640,
+ 0,
+ 593600512,
+ 0],
+ "memory_percent": 5.979987779195466,
+ "name": "code",
+ "nice": 0,
+ "num_threads": 13,
+ "pid": 60503,
+ "status": "S",
+ "time_since_update": 1,
+ "username": "nicolargo"}]
+
+Get a specific field::
+
+ # curl http://localhost:61208/api/3/processlist/pid
+ {"pid": [11043,
+ 60503,
+ 10541,
+ 50925,
+ 67269,
+ 10770,
+ 10778,
+ 59454,
+ 3927,
+ 59195,
+ 70920,
+ 10774,
+ 67532,
+ 55857,
+ 4288,
+ 10790,
+ 59069,
+ 10733,
+ 60104,
+ 59523,
+ 71710,
+ 59161,
+ 71792,
+ 60134,
+ 11646,
+ 71741,
+ 60106,
+ 60489,
+ 72099,
+ 71977,
+ 71875,
+ 59525,
+ 421,
+ 59663,
+ 60232,
+ 72192,
+ 3810,
+ 60191,
+ 59182,
+ 2398,
+ 11380,
+ 60192,
+ 10710,
+ 11381,
+ 4385,
+ 4179,
+ 4023,
+ 1771,
+ 4243,
+ 20173,
+ 3730,
+ 59126,
+ 17997,
+ 4000,
+ 59127,
+ 2636,
+ 42348,
+ 51297,
+ 4403,
+ 56140,
+ 4091,
+ 2168,
+ 1584,
+ 4046,
+ 4090,
+ 1727,
+ 4666,
+ 36919,
+ 1598,
+ 4075,
+ 1825,
+ 1618,
+ 4169,
+ 2554,
+ 2607,
+ 3956,
+ 1,
+ 4442,
+ 4339,
+ 1630,
+ 1794,
+ 51324,
+ 4308,
+ 3991,
+ 1605,
+ 4126,
+ 4086,
+ 1379,
+ 4080,
+ 2341,
+ 4244,
+ 3901,
+ 4078,
+ 3719,
+ 4105,
+ 3710,
+ 3908,
+ 4097,
+ 51357,
+ 3825,
+ 1764,
+ 4009,
+ 1631,
+ 1818,
+ 3115,
+ 1628,
+ 2116,
+ 1627,
+ 1566,
+ 14243,
+ 14266,
+ 3939,
+ 4119,
+ 3970,
+ 4145,
+ 3498,
+ 4033,
+ 3743,
+ 68552,
+ 3748,
+ 1583,
+ 4316,
+ 3952,
+ 4107,
+ 3925,
+ 21019,
+ 4062,
+ 1591,
+ 56119,
+ 2604,
+ 10848,
+ 4302,
+ 1606,
+ 1624,
+ 60199,
+ 4079,
+ 4196,
+ 4127,
+ 3745,
+ 4005,
+ 3975,
+ 1616,
+ 3947,
+ 4098,
+ 1380,
+ 4074,
+ 1612,
+ 4099,
+ 4157,
+ 461,
+ 3989,
+ 3819,
+ 2605,
+ 3727,
+ 3753,
+ 3728,
+ 1579,
+ 3888,
+ 3499,
+ 3934,
+ 1575,
+ 16182,
+ 1593,
+ 1377,
+ 1964,
+ 1582,
+ 18045,
+ 12489,
+ 12480,
+ 72157,
+ 1634,
+ 4332,
+ 1390,
+ 1391,
+ 3118,
+ 59145,
+ 3573,
+ 20400,
+ 2361,
+ 12492,
+ 3720,
+ 12483,
+ 1725,
+ 1726,
+ 4593,
+ 20396,
+ 20180,
+ 1567,
+ 72191,
+ 56106,
+ 56087,
+ 56100,
+ 56081,
+ 3794,
+ 4072,
+ 2358,
+ 3503,
+ 68389,
+ 1637,
+ 2382,
+ 2345,
+ 2360,
+ 20185,
+ 1392,
+ 1577,
+ 59130,
+ 12486,
+ 2,
+ 3,
+ 4,
+ 5,
+ 6,
+ 8,
+ 10,
+ 11,
+ 12,
+ 13,
+ 14,
+ 15,
+ 16,
+ 18,
+ 19,
+ 20,
+ 21,
+ 22,
+ 24,
+ 25,
+ 26,
+ 27,
+ 28,
+ 30,
+ 31,
+ 32,
+ 33,
+ 34,
+ 36,
+ 37,
+ 38,
+ 39,
+ 40,
+ 41,
+ 42,
+ 43,
+ 44,
+ 45,
+ 92,
+ 93,
+ 94,
+ 96,
+ 97,
+ 98,
+ 99,
+ 100,
+ 101,
+ 103,
+ 106,
+ 107,
+ 109,
+ 110,
+ 112,
+ 117,
+ 118,
+ 119,
+ 129,
+ 132,
+ 138,
+ 181,
+ 183,
+ 206,
+ 219,
+ 223,
+ 226,
+ 228,
+ 231,
+ 232,
+ 233,
+ 234,
+ 249,
+ 250,
+ 255,
+ 256,
+ 313,
+ 361,
+ 362,
+ 439,
+ 440,
+ 530,
+ 544,
+ 655,
+ 700,
+ 702,
+ 703,
+ 898,
+ 899,
+ 900,
+ 901,
+ 908,
+ 909,
+ 910,
+ 911,
+ 912,
+ 913,
+ 914,
+ 915,
+ 962,
+ 963,
+ 964,
+ 965,
+ 966,
+ 967,
+ 968,
+ 969,
+ 970,
+ 971,
+ 972,
+ 973,
+ 974,
+ 975,
+ 976,
+ 977,
+ 978,
+ 979,
+ 980,
+ 1001,
+ 1002,
+ 1009,
+ 1010,
+ 1031,
+ 1032,
+ 1033,
+ 1034,
+ 1035,
+ 1036,
+ 1037,
+ 2138,
+ 2140,
+ 2141,
+ 2142,
+ 2143,
+ 2394,
+ 2410,
+ 2422,
+ 2491,
+ 2492,
+ 2493,
+ 2506,
+ 2508,
+ 2510,
+ 2515,
+ 2525,
+ 3988,
+ 36366,
+ 45495,
+ 45496,
+ 45498,
+ 51075,
+ 51076,
+ 51078,
+ 51079,
+ 51081,
+ 51124,
+ 54611,
+ 66069,
+ 67615,
+ 67699,
+ 69087,
+ 69233,
+ 69313,
+ 69374,
+ 69647,
+ 70461,
+ 70622,
+ 70658,
+ 71347,
+ 71413,
+ 71823,
+ 71824,
+ 71836]}
+
+Get a specific item when field matchs the given value::
+
+ # curl http://localhost:61208/api/3/processlist/pid/11043
+ {"11043": [{"cmdline": ["/snap/firefox/2605/usr/lib/firefox/firefox",
+ "-contentproc",
+ "-childID",
+ "6",
+ "-isForBrowser",
+ "-prefsLen",
+ "38436",
+ "-prefMapSize",
+ "241898",
+ "-jsInitLen",
+ "240056",
+ "-parentBuildID",
+ "20230424185118",
+ "-appDir",
+ "/snap/firefox/2605/usr/lib/firefox/browser",
+ "{c94b5dea-52c6-4c75-a314-5de48bda9cdc}",
+ "10541",
+ "true",
+ "tab"],
+ "cpu_percent": 0.0,
+ "cpu_times": [357.9, 40.31, 0.0, 0.0, 0.0],
+ "gids": [1000, 1000, 1000],
+ "io_counters": [22819840, 0, 0, 0, 0],
+ "key": "pid",
+ "memory_info": [473870336,
+ 3517755392,
+ 86867968,
+ 618496,
+ 0,
+ 924098560,
+ 0],
+ "memory_percent": 6.047207431169115,
+ "name": "WebExtensions",
+ "nice": 0,
+ "num_threads": 20,
+ "pid": 11043,
+ "status": "S",
+ "time_since_update":