1fio2gnuplot(1) General Commands Manual fio2gnuplot(1)
2
6 fio2gnuplot - Render fio's output files with gnuplot
7
9 fio2gnuplot [-ghbiodvk] [-t title] [-o outputfile]
10 [-d output_dir] [-p pattern]
11 [-G type] [-m min_time] [-M max_time]
12
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 Individual 2D Graph
20 Each file is plotted in a separate image file with several op‐
21 tion
22 • raw : Plot the exact reported performance. This plotting
24 could be difficult to read
25 • 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 • 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 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 • raw
40 • smooth
42 • trend
44 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 Mathemical Plotting
52 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 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 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 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
77 -h or --help
78 The option -h displays help
79 -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 -b or --bandwidth
85 A predefined pattern for selecting *_bw.log files
86 -i or --iops
88 A predefined pattern for selecting *_iops.log files
89 -g or --gnuplot
91 Render gnuplot traces before exiting
92 -o file or --outputfile file
94 The basename for gnuplot traces (set with the pattern if de‐
95 fined)
96 -d dir or --outputdir dir
98 The directory where gnuplot shall render files.
99 -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 -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 -m time or --min_time time
110 Only consider data starting from 'time' seconds. Default is 0
111 -M time or --max_time time
113 Only consider data ending before 'time' seconds. Default is -1
114 aka nolimit
115 -v or --verbose
117 Increasing verbosity
118 -k or --keep
120 Keep all temporary files from gnuplot's output dir
121
123 To plot all the traces named like 'host*_read_4k_iops.log'
124 $ fio2gnuplot -p 'host*_read_4k_iops.log' -g
125 To plot all IO oriented log files from the current directory
127 $ fio2gnuplot -g -i
128 To plot all Bandwidth oriented log files from the current directory
130 $ fio2gnuplot -g -b
131 To plot all Bandwidth oriented log files in a directory name 'outdir'
133 $ fio2gnuplot -g -b -d outdir
134
136 Erwan Velu <erwan@enovance.com>
137 August 2013 fio2gnuplot(1)