Section 1 · User commands
fio2gnuplot.1
Package: fio
fio2gnuplot
NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLE
AUTHOR
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 comparison. 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>