projects / fio.git / blame
| Commit | Line | Data |
|---|---|---|
| 1378cc68 EV |
1 | NAME |
| 2 | fio2gnuplot - Render fio's output files with gnuplot | |
| 3 | SYNOPSIS | |
| 4 | fio2gnuplot [-ghbiodvk] [-t title] [-o outputfile] | |
| 5 | [-d output_dir] [-p pattern] | |
| 6 | [-G type] [-m min_time] [-M max_time] | |
| 7 | ||
| 8 | DESCRIPTION | |
| 9 | fio2gnuplot analyze a set of fio's log files to turn them into a set of graphical traces using gnuplot tool. | |
| 10 | Several flavor of plotting are produced | |
| 11 | ||
| 12 | Individual 2D Graph | |
| 13 | Each file is plotted in a separate image file with several option | |
| 14 | - raw : Plot the exact reported performance. This plotting could be difficult to read | |
| 15 | - smooth :a smoother version of the raw print | |
| 16 | Using csplines option of gnuplot, the rendering is | |
| 17 | filtered to get an easier to read graph. | |
| 18 | - trend : an even smoother version of the raw print to get trends | |
| 19 | Bezier's curves makes much more filtered plots | |
| 20 | The resulting graph helps at understanding trends. | |
| 21 | ||
| 22 | Grouped 2D graph | |
| 23 | All files are plotted in a single image to ease the comparaison. The same rendering options as per the individual 2D graph are used : | |
| 24 | - raw | |
| 25 | - smooth | |
| 26 | - trend | |
| 27 | ||
| 28 | Grouped 3D graph | |
| 29 | All files are plotted into a single 3D graph. | |
| 30 | The 3D plotting generates a 'surface' to estimate how close were | |
| 31 | the performance. | |
| 32 | A flat surface means a good coherency between traces. | |
| 33 | A rugged surface means a lack of coherency between traces | |
| 34 | ||
| 35 | Mathemical Plotting | |
| 36 | Average graph | |
| 37 | A bar graph to show the average performance of each file. | |
| 38 | A green line is added to show the global average performance. | |
| 39 | This green line helps at understanding how far from the average is | |
| 40 | every individual file. | |
| 41 | ||
| 42 | Min graph | |
| 43 | A green line is added to show the global average of minimal performance. | |
| 44 | This green line helps at understanding how far from the average is | |
| 45 | every individual file. | |
| 46 | ||
| 47 | Max graph | |
| 48 | A bar graph to show the maximum performance of each file. | |
| 49 | A green line is added to show the global average of maximal performance. | |
| 50 | This green line helps at understanding how far from the average is | |
| 51 | every individual file. | |
| 52 | ||
| 53 | Standard Deviation | |
| 54 | A bar graph to show the standard deviation of each file. | |
| 55 | A green line is added to show the global average of standard deviation. | |
| 56 | This green line helps at understanding how far from the average is | |
| 57 | every individual file. | |
| 58 | ||
| 59 | OPTIONS | |
| 60 | -h or --help | |
| 61 | The option -h displays help | |
| 62 | ||
| 63 | -p 'pattern' or --pattern 'pattern' | |
| 64 | A pattern in regexp to select fio input files. | |
| 65 | Don't forget the simple quotes to avoid shell's interactions | |
| 66 | ||
| 67 | -b or --bandwidth | |
| 68 | A predefined pattern for selecting *_bw.log files | |
| 69 | ||
| 70 | -i or --iops | |
| 71 | A predefined pattern for selecting *_iops.log files | |
| 72 | ||
| 73 | -g or --gnuplot | |
| 74 | Render gnuplot traces before exiting | |
| 75 | ||
| 76 | -o file or --outputfile file | |
| 77 | The basename for gnuplot traces (set with the pattern if defined) | |
| 78 | ||
| 79 | -d dir or --outputdir dir | |
| 80 | The directory where gnuplot shall render files. | |
| 81 | ||
| 82 | -t title or --title title | |
| 83 | The title of the gnuplot traces. | |
| 84 | Title is set with the block size detected in fio trace | |
| 85 | ||
| 86 | -G type or --Global type | |
| 87 | Search for 'type' in .global files match by a pattern. | |
| 88 | Available types are : min, max, avg, stddev. | |
| 89 | The .global extension is added automatically to the pattern | |
| 90 | ||
| 91 | -m time or --min_time time | |
| 92 | Only consider data starting from 'time' seconds. Default is 0 | |
| 93 | ||
| 94 | -M time or --max_time time | |
| 95 | Only consider data ending before 'time' seconds. Default is -1 aka nolimit | |
| 96 | ||
| 97 | -v or --verbose | |
| 98 | Increasing verbosity | |
| 99 | ||
| 100 | -k or --keep | |
| 101 | Keep all temporary files from gnuplot's output dir | |
| 102 | ||
| 103 | EXAMPLE | |
| 104 | To plot all the traces named like 'host*_read_4k_iops.log' | |
| 105 | $ fio2gnuplot -p 'host*_read_4k_iops.log' -g | |
| 106 | ||
| 107 | To plot all IO oriented log files from the current directory | |
| 108 | $ fio2gnuplot -g -i | |
| 109 | ||
| 110 | To plot all Bandwidth oriented log files from the current directory | |
| 111 | $ fio2gnuplot -g -b | |
| 112 | ||
| 113 | To plot all Bandwidth oriented log files in a directory name 'outdir' | |
| 114 | $ fio2gnuplot -g -b -d outdir | |
| 115 | ||
| 116 | AUTHOR | |
| 117 | Erwan Velu <erwan@enovance.com> |