dbuck(1)

NAME
dbuck - format output from pdsh command or similar

SYNOPSIS
dbuck [OPTION]...

DESCRIPTION
Reads data from stdin and outputs a human readable report on stdout. dbuck is similar to dshbak but is targeted at numerical data such as temperatures, power consumption, loadavg etc. Output is a bucket sorted table, a sort of histogram. Data is assumed to be N lines of data one for each host/entity. By default dbuck will autodetect the column to use (looking at the last three lines) and sort everything into five (linear) buckets. Any line missing numerical data at the targeted column will be ignored.

OPTIONS

-h, --help
    Print help message

-b LOW-HI, --bucket=LOW-HI
    Explicitly specify a bucket (option may be given more than once)

-k KEY, --key=KEY
    Use data at position KEY (default: auto)

-m,--merge-buckets
    Adaptively merge buckets when possible (default: False)

-n NBUCKETS, --nbuckets=NBUCKETS
    Number of buckets to use (default: 5)

-s, --statistics
    Output a statistical summary (min, max, mean, sum, ...)

-S, --chop-long-lines
    Chop too long lines / enforce one output line per bucket

-t FIELD_SEPARATORS, --field-separators=FIELD_SEPARATORS
    Additional field separators, space not optional (default: "")

-v, --verbose
    Be verbose

--debug
    Output debugging information

EXAMPLE
$ cat test/dbuck.testdata
 n1: 139 W
 n11: 128 W
 n13: 127 W
 n9: 127 W
 ...

$ cat test/dbuck.testdata | ./dbuck -s -n 4 --verbose
     Info: auto-detect unanimously selected key: 1
     Info: Creating simple linear bucket set
     Statistical summary
     --------------------------------------
     Number of values : 30
     Number of rejected lines : 0
     Min value : 115.000000
     Max value : 209.000000
     Mean : 135.466667
     Median : 127.005617
     Standard deviation : 25.807956
     Sum : 4064.000000
        LOW- HI: CNT HOSTLIST
     --------------------------------------
     115.00-138.50: 24 n[7-30]
     138.50-162.00: 2 n[1,3]
     162.00-185.50: 1 n6
     185.50-209.00: 3 n[2,4-5]

BUGS
When using either --merge-buckets or --bucket don't expect dbuck to give you exactly --nbuckets buckets. Also, don't expect dbuck to protect you from yourself should you specify unreasonable buckets.

AUTHOR
Written by Peter Kjellström <cap@nsc.liu.se>. The program is published part of python-hostlist at http://www.nsc.liu.se/~kent/python-hostlist/

SEE ALSO
hostlist (1) pdsh (1) dshbak (1)