2021-09-22 14:38:13 -07:00
|
|
|
[Home](https://kellyjonbrazil.github.io/jc/)
|
|
|
|
|
|
|
|
|
|
# jc.parsers.vmstat
|
|
|
|
|
jc - JSON CLI output utility `vmstat` command output parser
|
|
|
|
|
|
|
|
|
|
Options supported: `-a`, `-w`, `-d`, `-t`
|
|
|
|
|
|
2022-01-19 17:30:14 -08:00
|
|
|
The `epoch` calculated timestamp field is naive. (i.e. based on the local
|
|
|
|
|
time of the system the parser is run on)
|
2021-09-24 10:11:15 -07:00
|
|
|
|
2022-01-19 17:30:14 -08:00
|
|
|
The `epoch_utc` calculated timestamp field is timezone-aware and is only
|
|
|
|
|
available if the timezone field is UTC.
|
2021-09-24 10:11:15 -07:00
|
|
|
|
2021-09-22 14:38:13 -07:00
|
|
|
Usage (cli):
|
|
|
|
|
|
|
|
|
|
$ vmstat | jc --vmstat
|
|
|
|
|
|
|
|
|
|
or
|
|
|
|
|
|
|
|
|
|
$ jc vmstat
|
|
|
|
|
|
|
|
|
|
Usage (module):
|
|
|
|
|
|
2022-01-18 15:38:03 -08:00
|
|
|
import jc
|
|
|
|
|
result = jc.parse('vmstat', vmstat_command_output)
|
|
|
|
|
|
|
|
|
|
or
|
|
|
|
|
|
2021-09-22 14:38:13 -07:00
|
|
|
import jc.parsers.vmstat
|
|
|
|
|
result = jc.parsers.vmstat.parse(vmstat_command_output)
|
|
|
|
|
|
|
|
|
|
Schema:
|
|
|
|
|
|
|
|
|
|
[
|
|
|
|
|
{
|
2021-09-22 14:43:26 -07:00
|
|
|
"runnable_procs": integer,
|
|
|
|
|
"uninterruptible_sleeping_procs": integer,
|
|
|
|
|
"virtual_mem_used": integer,
|
|
|
|
|
"free_mem": integer,
|
|
|
|
|
"buffer_mem": integer,
|
|
|
|
|
"cache_mem": integer,
|
|
|
|
|
"inactive_mem": integer,
|
|
|
|
|
"active_mem": integer,
|
|
|
|
|
"swap_in": integer,
|
|
|
|
|
"swap_out": integer,
|
|
|
|
|
"blocks_in": integer,
|
|
|
|
|
"blocks_out": integer,
|
|
|
|
|
"interrupts": integer,
|
|
|
|
|
"context_switches": integer,
|
|
|
|
|
"user_time": integer,
|
|
|
|
|
"system_time": integer,
|
|
|
|
|
"idle_time": integer,
|
|
|
|
|
"io_wait_time": integer,
|
|
|
|
|
"stolen_time": integer,
|
|
|
|
|
"disk": string,
|
|
|
|
|
"total_reads": integer,
|
|
|
|
|
"merged_reads": integer,
|
|
|
|
|
"sectors_read": integer,
|
|
|
|
|
"reading_ms": integer,
|
|
|
|
|
"total_writes": integer,
|
|
|
|
|
"merged_writes": integer,
|
|
|
|
|
"sectors_written": integer,
|
|
|
|
|
"writing_ms": integer,
|
|
|
|
|
"current_io": integer,
|
|
|
|
|
"io_seconds": integer,
|
|
|
|
|
"timestamp": string,
|
|
|
|
|
"timezone": string,
|
2022-01-19 17:30:14 -08:00
|
|
|
"epoch": integer, # [0]
|
|
|
|
|
"epoch_utc": integer # [1]
|
2021-09-22 14:38:13 -07:00
|
|
|
}
|
|
|
|
|
]
|
|
|
|
|
|
2022-01-19 17:30:14 -08:00
|
|
|
[0] naive timestamp if -t flag is used
|
|
|
|
|
[1] aware timestamp if -t flag is used and UTC TZ
|
|
|
|
|
|
2021-09-22 14:38:13 -07:00
|
|
|
Examples:
|
|
|
|
|
|
|
|
|
|
$ vmstat | jc --vmstat -p
|
|
|
|
|
[
|
|
|
|
|
{
|
|
|
|
|
"runnable_procs": 2,
|
|
|
|
|
"uninterruptible_sleeping_procs": 0,
|
|
|
|
|
"virtual_mem_used": 0,
|
|
|
|
|
"free_mem": 2794468,
|
|
|
|
|
"buffer_mem": 2108,
|
|
|
|
|
"cache_mem": 741208,
|
|
|
|
|
"inactive_mem": null,
|
|
|
|
|
"active_mem": null,
|
|
|
|
|
"swap_in": 0,
|
|
|
|
|
"swap_out": 0,
|
|
|
|
|
"blocks_in": 1,
|
|
|
|
|
"blocks_out": 3,
|
|
|
|
|
"interrupts": 29,
|
|
|
|
|
"context_switches": 57,
|
|
|
|
|
"user_time": 0,
|
|
|
|
|
"system_time": 0,
|
|
|
|
|
"idle_time": 99,
|
|
|
|
|
"io_wait_time": 0,
|
|
|
|
|
"stolen_time": 0,
|
|
|
|
|
"timestamp": null,
|
|
|
|
|
"timezone": null
|
|
|
|
|
}
|
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
$ vmstat | jc --vmstat -p -r
|
|
|
|
|
[
|
|
|
|
|
{
|
|
|
|
|
"runnable_procs": "2",
|
|
|
|
|
"uninterruptible_sleeping_procs": "0",
|
|
|
|
|
"virtual_mem_used": "0",
|
|
|
|
|
"free_mem": "2794468",
|
|
|
|
|
"buffer_mem": "2108",
|
|
|
|
|
"cache_mem": "741208",
|
|
|
|
|
"inactive_mem": null,
|
|
|
|
|
"active_mem": null,
|
|
|
|
|
"swap_in": "0",
|
|
|
|
|
"swap_out": "0",
|
|
|
|
|
"blocks_in": "1",
|
|
|
|
|
"blocks_out": "3",
|
|
|
|
|
"interrupts": "29",
|
|
|
|
|
"context_switches": "57",
|
|
|
|
|
"user_time": "0",
|
|
|
|
|
"system_time": "0",
|
|
|
|
|
"idle_time": "99",
|
|
|
|
|
"io_wait_time": "0",
|
|
|
|
|
"stolen_time": "0",
|
|
|
|
|
"timestamp": null,
|
|
|
|
|
"timezone": null
|
|
|
|
|
}
|
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## info
|
|
|
|
|
```python
|
|
|
|
|
info()
|
|
|
|
|
```
|
|
|
|
|
Provides parser metadata (version, author, etc.)
|
|
|
|
|
|
|
|
|
|
## parse
|
|
|
|
|
```python
|
|
|
|
|
parse(data, raw=False, quiet=False)
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Main text parsing function
|
|
|
|
|
|
|
|
|
|
Parameters:
|
|
|
|
|
|
|
|
|
|
data: (string) text data to parse
|
2022-01-21 07:42:03 -08:00
|
|
|
raw: (boolean) unprocessed output if True
|
2021-09-22 14:38:13 -07:00
|
|
|
quiet: (boolean) suppress warning messages if True
|
|
|
|
|
|
|
|
|
|
Returns:
|
|
|
|
|
|
|
|
|
|
List of Dictionaries. Raw or processed structured data.
|
|
|
|
|
|
|
|
|
|
## Parser Information
|
|
|
|
|
Compatibility: linux
|
|
|
|
|
|
2021-12-01 16:12:51 -08:00
|
|
|
Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
|
