---
name: "fio2gnuplot"
section: "1"
platform: "linux"
package: "fio"
version: "3.42-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/fio2gnuplot"
---

# fio2gnuplot(1)

Render fio's output files with gnuplot

## NAME

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

## SYNOPSIS

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

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

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

  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

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

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

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