1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
|
.\" Text automatically generated by txt2man
.TH fio2gnuplot 1 "07 August 2013" "User Manual"
.SH NAME
\fBfio2gnuplot \fP- Render fio's output files with gnuplot
.SH SYNOPSIS
.nf
.fam C
\fBfio2gnuplot\fP [\fB-ghbiodvk\fP] [\fB-t\fP \fItitle\fP] [\fB-o\fP \fIoutputfile\fP]
[\fB-d\fP \fIoutput_dir\fP] [\fB-p\fP \fIpattern\fP]
[\fB-G\fP \fItype\fP] [\fB-m\fP \fImin_time\fP] [\fB-M\fP \fImax_time\fP]
.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
\fBfio2gnuplot\fP 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
.TP
.B
Individual 2D Graph
Each file is plotted in a separate image file with several option
.RS
.IP \(bu 3
raw : Plot the exact reported performance. This plotting could be difficult to read
.IP \(bu 3
smooth :a smoother version of the raw print
Using csplines option of gnuplot, the rendering is
filtered to get an easier to read graph.
.IP \(bu 3
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.
.RE
.TP
.B
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 :
.RS
.IP \(bu 3
raw
.IP \(bu 3
smooth
.IP \(bu 3
trend
.RE
.TP
.B
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
.TP
.B
Mathemical Plotting
.RS
.TP
.B
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.
.TP
.B
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.
.TP
.B
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.
.TP
.B
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.
.SH OPTIONS
.TP
.B
\fB-h\fP or \fB--help\fP
The option \fB-h\fP displays help
.TP
.B
\fB-p\fP '\fIpattern\fP' or --\fIpattern\fP '\fIpattern\fP'
A \fIpattern\fP in regexp to select fio input files.
Don't forget the simple quotes to avoid shell's interactions
.TP
.B
\fB-b\fP or \fB--bandwidth\fP
A predefined \fIpattern\fP for selecting *_bw.log files
.TP
.B
\fB-i\fP or \fB--iops\fP
A predefined \fIpattern\fP for selecting *_iops.log files
.TP
.B
\fB-g\fP or \fB--gnuplot\fP
Render gnuplot traces before exiting
.TP
.B
\fB-o\fP file or --\fIoutputfile\fP file
The basename for gnuplot traces (set with the \fIpattern\fP if defined)
.TP
.B
\fB-d\fP dir or \fB--outputdir\fP dir
The directory where gnuplot shall render files.
.TP
.B
\fB-t\fP \fItitle\fP or --\fItitle\fP \fItitle\fP
The \fItitle\fP of the gnuplot traces.
Title is set with the block size detected in fio trace
.TP
.B
\fB-G\fP \fItype\fP or \fB--Global\fP \fItype\fP
Search for '\fItype\fP' in .global files match by a \fIpattern\fP.
Available types are : min, max, avg, stddev.
The .global extension is added automatically to the \fIpattern\fP
.TP
.B
\fB-m\fP time or --\fImin_time\fP time
Only consider data starting from 'time' seconds. Default is 0
.TP
.B
\fB-M\fP time or --\fImax_time\fP time
Only consider data ending before 'time' seconds. Default is \fB-1\fP aka nolimit
.TP
.B
\fB-v\fP or \fB--verbose\fP
Increasing verbosity
.TP
.B
\fB-k\fP or \fB--keep\fP
Keep all temporary files from gnuplot's output dir
.SH EXAMPLE
.TP
.B
To plot all the traces named like 'host*_read_4k_iops.log'
$ \fBfio2gnuplot\fP \fB-p\fP 'host*_read_4k_iops.log' \fB-g\fP
.TP
.B
To plot all IO oriented log files from the current directory
$ \fBfio2gnuplot\fP \fB-g\fP \fB-i\fP
.TP
.B
To plot all Bandwidth oriented log files from the current directory
$ \fBfio2gnuplot\fP \fB-g\fP \fB-b\fP
.TP
.B
To plot all Bandwidth oriented log files in a directory name 'outdir'
$ \fBfio2gnuplot\fP \fB-g\fP \fB-b\fP \fB-d\fP outdir
.SH AUTHOR
Erwan Velu <erwan@enovance.com>
|
