fio2gnuplot(1) General Commands Manual fio2gnuplot(1)

# [NAME](#NAME)

**fio2gnuplot** - Render fio's output files with gnuplot

# [SYNOPSIS](#SYNOPSIS)

```
fio2gnuplot [-ghbiodvk] [-t title] [-o outputfile]


               [-d output_dir] [-p pattern]


               [-G type] [-m min_time] [-M max_time]
```

# [DESCRIPTION](#DESCRIPTION)

**fio2gnuplot** 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

[**Individual 2D Graph**](#Individual)

Each file is plotted in a separate image file with several option

- raw : Plot the exact reported performance. This plotting could be difficult to read
- smooth :a smoother version of the raw print Using 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**](#Grouped)

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**](#Grouped~2)

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

[**Mathemical Plotting**](#Mathemical)

[**Average graph**](#Average)

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**](#Min)

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**](#Max)

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**](#Standard)

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](#OPTIONS)

[**-h or --help**](#h)

The option **-h** displays help

[**-p '*pattern*' or --*pattern* '*pattern*'**](#p)

A *pattern* in regexp to select fio input files. Don't forget the simple quotes to avoid shell's interactions

[**-b or --bandwidth**](#b)

A predefined *pattern* for selecting \*\_bw.log files

[**-i or --iops**](#i)

A predefined *pattern* for selecting \*\_iops.log files

[**-g or --gnuplot**](#g)

Render gnuplot traces before exiting

[**-o file or --*outputfile* file**](#o)

The basename for gnuplot traces (set with the *pattern* if defined)

[**-d dir or --outputdir dir**](#d)

The directory where gnuplot shall render files.

[**-t *title* or --*title* *title***](#t)

The *title* of the gnuplot traces. Title is set with the block size detected in fio trace

[**-G *type* or --Global *type***](#G)

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**](#m)

Only consider data starting from 'time' seconds. Default is 0

[**-M time or --*max\_time* time**](#M)

Only consider data ending before 'time' seconds. Default is **-1** aka nolimit

[**-v or --verbose**](#v)

Increasing verbosity

[**-k or --keep**](#k)

Keep all temporary files from gnuplot's output dir

# [EXAMPLE](#EXAMPLE)

[**To plot all the traces named like 'host\*\_read\_4k\_iops.log'**](#To)

$ **fio2gnuplot** **-p** 'host\*\_read\_4k\_iops.log' **-g**

[**To plot all IO oriented log files from the current directory**](#To~2)

$ **fio2gnuplot** **-g** **-i**

[**To plot all Bandwidth oriented log files from the current directory**](#To~3)

$ **fio2gnuplot** **-g** **-b**

[**To plot all Bandwidth oriented log files in a directory name 'outdir'**](#To~4)

$ **fio2gnuplot** **-g** **-b** **-d** outdir

# [AUTHOR](#AUTHOR)

Erwan Velu <erwan@enovance.com>

August 2013

---

Document: fio2gnuplot(1) from fio 3.43-r0 (Chainguard OS)
Source: https://github.com/axboe/fio