fio2gnuplot(1)

✨ fio2gnuplot — the manual page, but make it cute ✨

okay bestie, so this is fio2gnuplot, and it lives in the General Commands Manual section. If you've ever wanted your fio logs to look pretty instead of like a wall of numbers, this is your girl. 🫶

---

💖 NAME 💖

fio2gnuplot — Render fio's output files with gnuplot

like. that's it. that's the job. it takes fio's output files and makes gnuplot draw them. iconic behaviour honestly. ✨

---

🌸 SYNOPSIS 🌸

fio2gnuplot [-ghbiodvk] [-t title] [-o outputfile]
               [-d output_dir] [-p pattern]
               [-G type] [-m min_time] [-M max_time]

---

🦋 DESCRIPTION 🦋

So fio2gnuplot analyzes a whole set of fio's log files and turns them into a set of graphical traces using the gnuplot tool. Several flavors of plotting are produced, and honestly? each one is serving a different purpose. let's get into it. 💅

📈 Individual 2D Graph

Each file is plotted in a separate image file, and you've got several options:

• raw : Plot the exact reported performance. This plotting could be difficult to read (ngl, it's giving chaos, but it's the truth of the data)
• smooth : a smoother version of the raw print. Using the csplines option of gnuplot, the rendering is filtered to get an easier to read graph.
• 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.

🌈 Grouped 2D graph

All files are plotted in a single image to ease the comparison. The same rendering options as per the individual 2D graph are used :

• raw
• smooth
• trend

🧊 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. it's giving vibe check for your benchmark results fr fr 🔥

🧮 Mathemical Plotting

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.

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.

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.

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.

---

👑 OPTIONS 👑

okay this is the part where you actually learn the flags. every single one, no skipping. 🎀

• -h or --help — The option -h displays help
• -p 'pattern' or --pattern 'pattern' — A pattern in regexp to select fio input files. Don't forget the simple quotes to avoid shell's interactions. (the quotes are NOT optional bestie, your shell will eat your pattern alive 😭)
• -b or --bandwidth — A predefined pattern for selecting *_bw.log files
• -i or --iops — A predefined pattern for selecting *_iops.log files
• -g or --gnuplot — Render gnuplot traces before exiting
• -o file or --outputfile file — The basename for gnuplot traces (set with the pattern if defined)
• -d dir or --outputdir dir — The directory where gnuplot shall render files.
• -t title or --title title — The title of the gnuplot traces. Title is set with the block size detected in fio trace
• -G type or --Global type — Search for 'type' in .global files match by a pattern. Available types are : min, max, avg, stddev. The .global extension is added automatically to the pattern
• -m time or --min_time time — Only consider data starting from 'time' seconds. Default is 0
• -M time or --max_time time — Only consider data ending before 'time' seconds. Default is -1 aka nolimit
• -v or --verbose — Increasing verbosity
• -k or --keep — Keep all temporary files from gnuplot's output dir

---

🌟 EXAMPLE 🌟

To plot all the traces named like 'host*_read_4k_iops.log'

$ fio2gnuplot -p 'host*_read_4k_iops.log' -g

To plot all IO oriented log files from the current directory

$ fio2gnuplot -g -i

To plot all Bandwidth oriented log files from the current directory

$ fio2gnuplot -g -b

To plot all Bandwidth oriented log files in a directory name 'outdir'

$ fio2gnuplot -g -b -d outdir

---

🎀 AUTHOR 🎀

Erwan Velu <erwan@enovance.com>

---

August 2013 — that's when this page was dated, and this is fio2gnuplot(1) from the General Commands Manual, signing off. go plot something gorgeous bestie, you got this 💖✨🦋