Provided by: fio_3.28-1_amd64 bug

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>