1fio2gnuplot(1)              General Commands Manual             fio2gnuplot(1)
2
3
4

NAME

6       fio2gnuplot - Render fio's output files with gnuplot
7

SYNOPSIS

9       fio2gnuplot [-ghbiodvk] [-t title] [-o outputfile]
10                      [-d output_dir] [-p pattern]
11                      [-G type] [-m min_time] [-M max_time]
12
13

DESCRIPTION

15       fio2gnuplot analyze a set of fio's log files to turn them into a set of
16       graphical traces using gnuplot tool.  Several flavor  of  plotting  are
17       produced
18
19       Individual 2D Graph
20              Each  file  is plotted in a separate image file with several op‐
21              tion
22
23              •  raw : Plot the  exact  reported  performance.  This  plotting
24                 could be difficult to read
25
26              •  smooth  :a  smoother  version of the raw print Using csplines
27                 option of gnuplot, the rendering is filtered to get an easier
28                 to read graph.
29
30              •  trend  :  an  even  smoother  version of the raw print to get
31                 trends Bezier's curves makes much more filtered plots The re‐
32                 sulting graph helps at understanding trends.
33
34       Grouped 2D graph
35              All  files are plotted in a single image to ease the comparison.
36              The same rendering options as per the individual  2D  graph  are
37              used :
38
39              •  raw
40
41              •  smooth
42
43              •  trend
44
45       Grouped 3D graph
46              All  files  are plotted into a single 3D graph.  The 3D plotting
47              generates a 'surface' to estimate how  close  were  the  perfor‐
48              mance.  A flat surface means a good coherency between traces.  A
49              rugged surface means a lack of coherency between traces
50
51       Mathemical Plotting
52
53              Average graph
54                     A bar graph to show the average performance of each file.
55                     A  green line is added to show the global average perfor‐
56                     mance.  This green line helps at  understanding  how  far
57                     from the average is every individual file.
58
59              Min graph
60                     A green line is added to show the global average of mini‐
61                     mal performance.  This green line helps at  understanding
62                     how far from the average is every individual file.
63
64              Max graph
65                     A bar graph to show the maximum performance of each file.
66                     A green line is added to show the global average of maxi‐
67                     mal  performance.  This green line helps at understanding
68                     how far from the average is every individual file.
69
70              Standard Deviation
71                     A bar graph to show the standard deviation of each  file.
72                     A green line is added to show the global average of stan‐
73                     dard deviation.  This green line helps  at  understanding
74                     how far from the average is every individual file.
75

OPTIONS

77       -h or --help
78              The option -h displays help
79
80       -p 'pattern' or --pattern 'pattern'
81              A pattern in regexp to select fio input files.  Don't forget the
82              simple quotes to avoid shell's interactions
83
84       -b or --bandwidth
85              A predefined pattern for selecting *_bw.log files
86
87       -i or --iops
88              A predefined pattern for selecting *_iops.log files
89
90       -g or --gnuplot
91              Render gnuplot traces before exiting
92
93       -o file or --outputfile file
94              The basename for gnuplot traces (set with  the  pattern  if  de‐
95              fined)
96
97       -d dir or --outputdir dir
98              The directory where gnuplot shall render files.
99
100       -t title or --title title
101              The  title  of  the gnuplot traces.  Title is set with the block
102              size detected in fio trace
103
104       -G type or --Global type
105              Search for 'type' in .global files match by a  pattern.   Avail‐
106              able  types  are : min, max, avg, stddev.  The .global extension
107              is added automatically to the pattern
108
109       -m time or --min_time time
110              Only consider data starting from 'time' seconds. Default is 0
111
112       -M time or --max_time time
113              Only consider data ending before 'time' seconds. Default  is  -1
114              aka nolimit
115
116       -v or --verbose
117              Increasing verbosity
118
119       -k or --keep
120              Keep all temporary files from gnuplot's output dir
121

EXAMPLE

123       To plot all the traces named like 'host*_read_4k_iops.log'
124              $ fio2gnuplot -p 'host*_read_4k_iops.log' -g
125
126       To plot all IO oriented log files from the current directory
127              $ fio2gnuplot -g -i
128
129       To plot all Bandwidth oriented log files from the current directory
130              $ fio2gnuplot -g -b
131
132       To plot all Bandwidth oriented log files in a directory name 'outdir'
133              $ fio2gnuplot -g -b -d outdir
134

AUTHOR

136       Erwan Velu <erwan@enovance.com>
137
138
139
140                                  August 2013                   fio2gnuplot(1)
Impressum