|
Packit |
8930e1 |
.\" Text automatically generated by txt2man
|
|
Packit |
8930e1 |
.TH fio2gnuplot 1 "August 2013"
|
|
Packit |
8930e1 |
.SH NAME
|
|
Packit |
8930e1 |
\fBfio2gnuplot \fP- Render fio's output files with gnuplot
|
|
Packit |
8930e1 |
.SH SYNOPSIS
|
|
Packit |
8930e1 |
.nf
|
|
Packit |
8930e1 |
.fam C
|
|
Packit |
8930e1 |
\fBfio2gnuplot\fP [\fB-ghbiodvk\fP] [\fB-t\fP \fItitle\fP] [\fB-o\fP \fIoutputfile\fP]
|
|
Packit |
8930e1 |
[\fB-d\fP \fIoutput_dir\fP] [\fB-p\fP \fIpattern\fP]
|
|
Packit |
8930e1 |
[\fB-G\fP \fItype\fP] [\fB-m\fP \fImin_time\fP] [\fB-M\fP \fImax_time\fP]
|
|
Packit |
8930e1 |
|
|
Packit |
8930e1 |
.fam T
|
|
Packit |
8930e1 |
.fi
|
|
Packit |
8930e1 |
.fam T
|
|
Packit |
8930e1 |
.fi
|
|
Packit |
8930e1 |
.SH DESCRIPTION
|
|
Packit |
8930e1 |
\fBfio2gnuplot\fP analyze a set of fio's log files to turn them into a set of graphical traces using gnuplot tool.
|
|
Packit |
8930e1 |
Several flavor of plotting are produced
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
Individual 2D Graph
|
|
Packit |
8930e1 |
Each file is plotted in a separate image file with several option
|
|
Packit |
8930e1 |
.RS
|
|
Packit |
8930e1 |
.IP \(bu 3
|
|
Packit |
8930e1 |
raw : Plot the exact reported performance. This plotting could be difficult to read
|
|
Packit |
8930e1 |
.IP \(bu 3
|
|
Packit |
8930e1 |
smooth :a smoother version of the raw print
|
|
Packit |
8930e1 |
Using csplines option of gnuplot, the rendering is
|
|
Packit |
8930e1 |
filtered to get an easier to read graph.
|
|
Packit |
8930e1 |
.IP \(bu 3
|
|
Packit |
8930e1 |
trend : an even smoother version of the raw print to get trends
|
|
Packit |
8930e1 |
Bezier's curves makes much more filtered plots
|
|
Packit |
8930e1 |
The resulting graph helps at understanding trends.
|
|
Packit |
8930e1 |
.RE
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
Grouped 2D graph
|
|
Packit |
8930e1 |
All files are plotted in a single image to ease the comparaison. The same rendering options as per the individual 2D graph are used :
|
|
Packit |
8930e1 |
.RS
|
|
Packit |
8930e1 |
.IP \(bu 3
|
|
Packit |
8930e1 |
raw
|
|
Packit |
8930e1 |
.IP \(bu 3
|
|
Packit |
8930e1 |
smooth
|
|
Packit |
8930e1 |
.IP \(bu 3
|
|
Packit |
8930e1 |
trend
|
|
Packit |
8930e1 |
.RE
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
Grouped 3D graph
|
|
Packit |
8930e1 |
All files are plotted into a single 3D graph.
|
|
Packit |
8930e1 |
The 3D plotting generates a 'surface' to estimate how close were
|
|
Packit |
8930e1 |
the performance.
|
|
Packit |
8930e1 |
A flat surface means a good coherency between traces.
|
|
Packit |
8930e1 |
A rugged surface means a lack of coherency between traces
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
Mathemical Plotting
|
|
Packit |
8930e1 |
.RS
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
Average graph
|
|
Packit |
8930e1 |
A bar graph to show the average performance of each file.
|
|
Packit |
8930e1 |
A green line is added to show the global average performance.
|
|
Packit |
8930e1 |
This green line helps at understanding how far from the average is
|
|
Packit |
8930e1 |
every individual file.
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
Min graph
|
|
Packit |
8930e1 |
A green line is added to show the global average of minimal performance.
|
|
Packit |
8930e1 |
This green line helps at understanding how far from the average is
|
|
Packit |
8930e1 |
every individual file.
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
Max graph
|
|
Packit |
8930e1 |
A bar graph to show the maximum performance of each file.
|
|
Packit |
8930e1 |
A green line is added to show the global average of maximal performance.
|
|
Packit |
8930e1 |
This green line helps at understanding how far from the average is
|
|
Packit |
8930e1 |
every individual file.
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
Standard Deviation
|
|
Packit |
8930e1 |
A bar graph to show the standard deviation of each file.
|
|
Packit |
8930e1 |
A green line is added to show the global average of standard deviation.
|
|
Packit |
8930e1 |
This green line helps at understanding how far from the average is
|
|
Packit |
8930e1 |
every individual file.
|
|
Packit |
8930e1 |
.SH OPTIONS
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
\fB-h\fP or \fB--help\fP
|
|
Packit |
8930e1 |
The option \fB-h\fP displays help
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
\fB-p\fP '\fIpattern\fP' or --\fIpattern\fP '\fIpattern\fP'
|
|
Packit |
8930e1 |
A \fIpattern\fP in regexp to select fio input files.
|
|
Packit |
8930e1 |
Don't forget the simple quotes to avoid shell's interactions
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
\fB-b\fP or \fB--bandwidth\fP
|
|
Packit |
8930e1 |
A predefined \fIpattern\fP for selecting *_bw.log files
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
\fB-i\fP or \fB--iops\fP
|
|
Packit |
8930e1 |
A predefined \fIpattern\fP for selecting *_iops.log files
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
\fB-g\fP or \fB--gnuplot\fP
|
|
Packit |
8930e1 |
Render gnuplot traces before exiting
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
\fB-o\fP file or --\fIoutputfile\fP file
|
|
Packit |
8930e1 |
The basename for gnuplot traces (set with the \fIpattern\fP if defined)
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
\fB-d\fP dir or \fB--outputdir\fP dir
|
|
Packit |
8930e1 |
The directory where gnuplot shall render files.
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
\fB-t\fP \fItitle\fP or --\fItitle\fP \fItitle\fP
|
|
Packit |
8930e1 |
The \fItitle\fP of the gnuplot traces.
|
|
Packit |
8930e1 |
Title is set with the block size detected in fio trace
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
\fB-G\fP \fItype\fP or \fB--Global\fP \fItype\fP
|
|
Packit |
8930e1 |
Search for '\fItype\fP' in .global files match by a \fIpattern\fP.
|
|
Packit |
8930e1 |
Available types are : min, max, avg, stddev.
|
|
Packit |
8930e1 |
The .global extension is added automatically to the \fIpattern\fP
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
\fB-m\fP time or --\fImin_time\fP time
|
|
Packit |
8930e1 |
Only consider data starting from 'time' seconds. Default is 0
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
\fB-M\fP time or --\fImax_time\fP time
|
|
Packit |
8930e1 |
Only consider data ending before 'time' seconds. Default is \fB-1\fP aka nolimit
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
\fB-v\fP or \fB--verbose\fP
|
|
Packit |
8930e1 |
Increasing verbosity
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
\fB-k\fP or \fB--keep\fP
|
|
Packit |
8930e1 |
Keep all temporary files from gnuplot's output dir
|
|
Packit |
8930e1 |
.SH EXAMPLE
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
To plot all the traces named like 'host*_read_4k_iops.log'
|
|
Packit |
8930e1 |
$ \fBfio2gnuplot\fP \fB-p\fP 'host*_read_4k_iops.log' \fB-g\fP
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
To plot all IO oriented log files from the current directory
|
|
Packit |
8930e1 |
$ \fBfio2gnuplot\fP \fB-g\fP \fB-i\fP
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
To plot all Bandwidth oriented log files from the current directory
|
|
Packit |
8930e1 |
$ \fBfio2gnuplot\fP \fB-g\fP \fB-b\fP
|
|
Packit |
8930e1 |
.TP
|
|
Packit |
8930e1 |
.B
|
|
Packit |
8930e1 |
To plot all Bandwidth oriented log files in a directory name 'outdir'
|
|
Packit |
8930e1 |
$ \fBfio2gnuplot\fP \fB-g\fP \fB-b\fP \fB-d\fP outdir
|
|
Packit |
8930e1 |
.SH AUTHOR
|
|
Packit |
8930e1 |
Erwan Velu <erwan@enovance.com>
|