cijoe-pkg-fio 0.0.2

CIJOE: extract data from fio dumps

cijoe-pkg-fio: cijoe package wrapping fio workloads

Install

The package is distributed via PyPi, run the following to command to install:

pip3 install --user cijoe-pkg-fio

To install the development preview, install:

pip3 install --user --pre cijoe-pkg-fio

See the Cijoe for additional documentation.

If you find bugs or need help then feel free to submit an Issue. If you want to get involved head over to the GitHub page to get the source code and submit a Pull request with your changes.

Note

When doing user-level install, then include the pip3 binary install path in your PATH definition. For example PATH="$PATH:$HOME/.local/bin"

Create environment definition for CIJOE

Run CIJOE interactively and define the target environment:

# Start cijoe
cijoe

# Use refence definitions as a template for defining your environment
cat envs/refenv-fio.sh > target_env.sh

# Open up your favorite editor and modify accordingly
vim target_env.sh

Running tests

Start the test-runner and view the report:

# Directory containing results from cijoe run with `fio-output*` files
RESULTS=/path/to/dir/with/fio-output/files/

# Run using the testplan exercising fio
cij_extractor \
    --extractor fio_json_read
    --output $RESULTS

# metrics.yml files will be dumped for each test case containing
# `fio-output*` files

Example of how the extractor can be used with the included fio example plan. This will generate a file called metrics.yml in the output directory for the fio_example test.

OUTPUT=$(mktemp -d)
cij_runner --testplan ./testplans/fio_example.plan --env ./your_target_env.sh --output $OUTPUT
cij_extractor --extractor fio_json_read --output $OUTPUT

If you find bugs or need help then feel free to submit an Issue. If you want to get involved head over to the GitHub page to get the source code and submit a Pull request with your changes.