fio2gnuplot man page
fio2gnuplot — Render fio's output files with gnuplot
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 :
- 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.
- -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
- 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
Erwan Velu <firstname.lastname@example.org>