| 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> |