fio2gnuplot

fio2gnuplot(07 août 2013)                              fio2gnuplot(07 août 2013)



NAME
       fio2gnuplot - Render fio's output files with gnuplot

SYNOPSIS
       fio2gnuplot [-ghbiodvk] [-t title] [-o outputfile]
                      [-d output_dir] [-p pattern]
                      [-G type] [-m min_time] [-M max_time]


DESCRIPTION
       fio2gnuplot analyze a set of fio's log files to turn them into a set of
       graphical traces using gnuplot tool.  Several flavor of plotting are
       produced

       Individual 2D Graph
              Each file is plotted in a separate image file with several option

              •  raw : Plot the exact reported performance. This plotting could
                 be difficult to read

              •  smooth :a smoother version of the raw print Using csplines
                 option of gnuplot, the rendering is filtered to get an easier
                 to read graph.

              •  trend : an even smoother version of the raw print to get trends
                 Bezier's curves makes much more filtered plots The resulting
                 graph helps at understanding trends.

       Grouped 2D graph
              All files are plotted in a single image to ease the comparaison.
              The same rendering options as per the individual 2D graph are used
              :

              •  raw

              •  smooth

              •  trend

       Grouped 3D graph
              All files are plotted into a single 3D graph.  The 3D plotting
              generates a 'surface' to estimate how close were the performance.
              A flat surface means a good coherency between traces.  A rugged
              surface means a lack of coherency between traces

       Mathemical Plotting

              Average graph
                     A bar graph to show the average performance of each file.
                     A green line is added to show the global average
                     performance.  This green line helps at understanding how
                     far from the average is every individual file.

              Min graph
                     A green line is added to show the global average of minimal
                     performance.  This green line helps at understanding how
                     far from the average is every individual file.

              Max graph
                     A bar graph to show the maximum performance of each file.
                     A green line is added to show the global average of maximal
                     performance.  This green line helps at understanding how
                     far from the average is every individual file.

              Standard Deviation
                     A bar graph to show the standard deviation of each file.  A
                     green line is added to show the global average of standard
                     deviation.  This green line helps at understanding how far
                     from the average is every individual file.

OPTIONS
       -h or --help
              The option -h displays help

       -p 'pattern' or --pattern 'pattern'
              A pattern in regexp to select fio input files.  Don't forget the
              simple quotes to avoid shell's interactions

       -b or --bandwidth
              A predefined pattern for selecting *_bw.log files

       -i or --iops
              A predefined pattern for selecting *_iops.log files

       -g or --gnuplot
              Render gnuplot traces before exiting

       -o file or --outputfile file
              The basename for gnuplot traces (set with the pattern if defined)

       -d dir or --outputdir dir
              The directory where gnuplot shall render files.

       -t title or --title title
              The title of the gnuplot traces.  Title is set with the block size
              detected in fio trace

       -G type or --Global type
              Search for 'type' in .global files match by a pattern.  Available
              types are : min, max, avg, stddev.  The .global extension is added
              automatically to the pattern

       -m time or --min_time time
              Only consider data starting from 'time' seconds. Default is 0

       -M time or --max_time time
              Only consider data ending before 'time' seconds. Default is -1 aka
              nolimit

       -v or --verbose
              Increasing verbosity

       -k or --keep
              Keep all temporary files from gnuplot's output dir

EXAMPLE
       To plot all the traces named like 'host*_read_4k_iops.log'
              $ fio2gnuplot -p 'host*_read_4k_iops.log' -g

       To plot all IO oriented log files from the current directory
              $ fio2gnuplot -g -i

       To plot all Bandwidth oriented log files from the current directory
              $ fio2gnuplot -g -b

       To plot all Bandwidth oriented log files in a directory name 'outdir'
              $ fio2gnuplot -g -b -d outdir

AUTHOR
       Erwan Velu <erwan@enovance.com>



                                                       fio2gnuplot(07 août 2013)