fio
Fio runs the open-source fio tool from CloudAI. It supports standalone and Slurm systems.
Scenarios
Use conf/common/test_scenario/fio.toml for Slurm clusters. It runs the common fio test in a container and starts 4 tasks total: num_nodes = 2 and num_tasks_per_node = 2.
Use conf/common/test_scenario/fio_local.toml for local/standalone runs. It uses host-installed fio and no container image.
Fio Arguments
Put fio CLI options under cmd_args.args. CloudAI does not declare a fixed fio option list; keys pass through verbatim.
This emits options like --rw=randwrite and --group_reporting. Quote TOML keys when option names contain characters such as -:
List values are CloudAI DSE sweeps:
To repeat the same fio option in one run, use a nested table. Nested key names are only stable TOML item names; values become fio values:
For existing or complex fio configs, use job_file:
Slurm Tasks
Scenario num_nodes controls node count. cmd_args.num_tasks_per_node controls Slurm tasks per node. Total fio tasks = num_nodes * num_tasks_per_node. CloudAI passes this as --ntasks and --ntasks-per-node.
Default Metric
For agent_metrics = ["default"], CloudAI aggregates parsed fio summary rows. Defaults report total bandwidth across all operations and tasks. Bandwidth metrics are normalized to MiB/s before aggregation. Latency metrics are normalized to usec before aggregation.
Raw parsed rows and normalized metric values are written to fio_summary.csv.
API Documentation
Command Arguments
FioCmdArgs
Command line arguments for fio.
Test Definition
FioTestDefinition
Test definition for fio.