Home

jc.parsers.mpstat_s

jc - JSON Convert mpstat command output streaming parser

This streaming parser outputs JSON Lines (cli) or returns an Iterable of Dictionaries (module)

Note: Latest versions of mpstat support JSON output (v11.5.1+)

Usage (cli):

$ mpstat | jc --mpstat-s

Usage (module):

import jc

result = jc.parse('mpstat_s', mpstat_command_output.splitlines())
for item in result:
    # do something

Schema:

{
  "type":               string,
  "time":               string,
  "cpu":                string,
  "node":               string,
  "average":            boolean,
  "percent_usr":        float,
  "percent_nice":       float,
  "percent_sys":        float,
  "percent_iowait":     float,
  "percent_irq":        float,
  "percent_soft":       float,
  "percent_steal":      float,
  "percent_guest":      float,
  "percent_gnice":      float,
  "percent_idle":       float,
  "intr_s":             float,
  "<x>_s":              float,      # <x> is an integer
  "nmi_s":              float,
  "loc_s":              float,
  "spu_s":              float,
  "pmi_s":              float,
  "iwi_s":              float,
  "rtr_s":              float,
  "res_s":              float,
  "cal_s":              float,
  "tlb_s":              float,
  "trm_s":              float,
  "thr_s":              float,
  "dfr_s":              float,
  "mce_s":              float,
  "mcp_s":              float,
  "err_s":              float,
  "mis_s":              float,
  "pin_s":              float,
  "npi_s":              float,
  "piw_s":              float,
  "hi_s":               float,
  "timer_s":            float,
  "net_tx_s":           float,
  "net_rx_s":           float,
  "block_s":            float,
  "irq_poll_s":         float,
  "block_iopoll_s":     float,
  "tasklet_s":          float,
  "sched_s":            float,
  "hrtimer_s":          float,
  "rcu_s":              float,

  # below object only exists if using -qq or ignore_exceptions=True
  "_jc_meta": {
    "success":          boolean,     # false if error parsing
    "error":            string,      # exists if "success" is false
    "line":             string       # exists if "success" is false
  }
}

Examples:

$ mpstat -A | jc --mpstat-s
{"cpu":"all","percent_usr":0.22,"percent_nice":0.0,"percent_sys":...}
{"cpu":"0","percent_usr":0.22,"percent_nice":0.0,"percent_sys":0....}
{"cpu":"all","intr_s":37.61,"type":"interrupts","time":"03:15:06 PM"}
...

$ mpstat -A | jc --mpstat-s -r
{"cpu":"all","percent_usr":"0.22","percent_nice":"0.00","percent_...}
{"cpu":"0","percent_usr":"0.22","percent_nice":"0.00","percent_sy...}
{"cpu":"all","intr_s":"37.61","type":"interrupts","time":"03:15:06 PM"}
...

parse

def parse(data: Iterable[str],
          raw: bool = False,
          quiet: bool = False,
          ignore_exceptions: bool = False) -> Union[Iterable[Dict], tuple]

Main text parsing generator function. Returns an iterable object.

Parameters:

data:              (iterable)  line-based text data to parse
                               (e.g. sys.stdin or str.splitlines())

raw:               (boolean)   unprocessed output if True
quiet:             (boolean)   suppress warning messages if True
ignore_exceptions: (boolean)   ignore parsing exceptions if True

Returns:

Iterable of Dictionaries

Parser Information

Compatibility: linux

Source: jc/parsers/mpstat_s.py

Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)