222 lines
9.7 KiB
Python
Executable file
222 lines
9.7 KiB
Python
Executable file
#!/usr/bin/python
|
|
#
|
|
# steadystate_tests.py
|
|
#
|
|
# Test option parsing and functonality for fio's steady state detection feature.
|
|
#
|
|
# steadystate_tests.py ./fio file-for-read-testing file-for-write-testing
|
|
#
|
|
# REQUIREMENTS
|
|
# Python 2.6+
|
|
# SciPy
|
|
#
|
|
# KNOWN ISSUES
|
|
# only option parsing and read tests are carried out
|
|
# On Windows this script works under Cygwin but not from cmd.exe
|
|
# On Windows I encounter frequent fio problems generating JSON output (nothing to decode)
|
|
# min runtime:
|
|
# if ss attained: min runtime = ss_dur + ss_ramp
|
|
# if not attained: runtime = timeout
|
|
|
|
import os
|
|
import sys
|
|
import json
|
|
import uuid
|
|
import pprint
|
|
import argparse
|
|
import subprocess
|
|
from scipy import stats
|
|
|
|
def parse_args():
|
|
parser = argparse.ArgumentParser()
|
|
parser.add_argument('fio',
|
|
help='path to fio executable');
|
|
parser.add_argument('--read',
|
|
help='target for read testing')
|
|
parser.add_argument('--write',
|
|
help='target for write testing')
|
|
args = parser.parse_args()
|
|
|
|
return args
|
|
|
|
|
|
def check(data, iops, slope, pct, limit, dur, criterion):
|
|
measurement = 'iops' if iops else 'bw'
|
|
data = data[measurement]
|
|
mean = sum(data) / len(data)
|
|
if slope:
|
|
x = range(len(data))
|
|
m, intercept, r_value, p_value, std_err = stats.linregress(x,data)
|
|
m = abs(m)
|
|
if pct:
|
|
target = m / mean * 100
|
|
criterion = criterion[:-1]
|
|
else:
|
|
target = m
|
|
else:
|
|
maxdev = 0
|
|
for x in data:
|
|
maxdev = max(abs(mean-x), maxdev)
|
|
if pct:
|
|
target = maxdev / mean * 100
|
|
criterion = criterion[:-1]
|
|
else:
|
|
target = maxdev
|
|
|
|
criterion = float(criterion)
|
|
return (abs(target - criterion) / criterion < 0.005), target < limit, mean, target
|
|
|
|
|
|
if __name__ == '__main__':
|
|
args = parse_args()
|
|
|
|
pp = pprint.PrettyPrinter(indent=4)
|
|
|
|
#
|
|
# test option parsing
|
|
#
|
|
parsing = [ { 'args': ["--parse-only", "--debug=parse", "--ss_dur=10s", "--ss=iops:10", "--ss_ramp=5"],
|
|
'output': "set steady state IOPS threshold to 10.000000" },
|
|
{ 'args': ["--parse-only", "--debug=parse", "--ss_dur=10s", "--ss=iops:10%", "--ss_ramp=5"],
|
|
'output': "set steady state threshold to 10.000000%" },
|
|
{ 'args': ["--parse-only", "--debug=parse", "--ss_dur=10s", "--ss=iops:.1%", "--ss_ramp=5"],
|
|
'output': "set steady state threshold to 0.100000%" },
|
|
{ 'args': ["--parse-only", "--debug=parse", "--ss_dur=10s", "--ss=bw:10%", "--ss_ramp=5"],
|
|
'output': "set steady state threshold to 10.000000%" },
|
|
{ 'args': ["--parse-only", "--debug=parse", "--ss_dur=10s", "--ss=bw:.1%", "--ss_ramp=5"],
|
|
'output': "set steady state threshold to 0.100000%" },
|
|
{ 'args': ["--parse-only", "--debug=parse", "--ss_dur=10s", "--ss=bw:12", "--ss_ramp=5"],
|
|
'output': "set steady state BW threshold to 12" },
|
|
]
|
|
for test in parsing:
|
|
output = subprocess.check_output([args.fio] + test['args']);
|
|
if test['output'] in output:
|
|
print "PASSED '{0}' found with arguments {1}".format(test['output'], test['args'])
|
|
else:
|
|
print "FAILED '{0}' NOT found with arguments {1}".format(test['output'], test['args'])
|
|
|
|
#
|
|
# test some read workloads
|
|
#
|
|
# if ss active and attained,
|
|
# check that runtime is less than job time
|
|
# check criteria
|
|
# how to check ramp time?
|
|
#
|
|
# if ss inactive
|
|
# check that runtime is what was specified
|
|
#
|
|
reads = [ {'s': True, 'timeout': 100, 'numjobs': 1, 'ss_dur': 5, 'ss_ramp': 3, 'iops': True, 'slope': True, 'ss_limit': 0.1, 'pct': True},
|
|
{'s': False, 'timeout': 20, 'numjobs': 2},
|
|
{'s': True, 'timeout': 100, 'numjobs': 3, 'ss_dur': 10, 'ss_ramp': 5, 'iops': False, 'slope': True, 'ss_limit': 0.1, 'pct': True},
|
|
{'s': True, 'timeout': 10, 'numjobs': 3, 'ss_dur': 10, 'ss_ramp': 500, 'iops': False, 'slope': True, 'ss_limit': 0.1, 'pct': True},
|
|
]
|
|
|
|
if args.read == None:
|
|
if os.name == 'posix':
|
|
args.read = '/dev/zero'
|
|
extra = [ "--size=134217728" ] # 128 MiB
|
|
else:
|
|
print "ERROR: file for read testing must be specified on non-posix systems"
|
|
sys.exit(1)
|
|
else:
|
|
extra = []
|
|
|
|
jobnum = 0
|
|
for job in reads:
|
|
|
|
tf = uuid.uuid4().hex
|
|
parameters = [ "--name=job{0}".format(jobnum) ]
|
|
parameters.extend(extra)
|
|
parameters.extend([ "--thread",
|
|
"--output-format=json",
|
|
"--output={0}".format(tf),
|
|
"--filename={0}".format(args.read),
|
|
"--rw=randrw",
|
|
"--rwmixread=100",
|
|
"--stonewall",
|
|
"--group_reporting",
|
|
"--numjobs={0}".format(job['numjobs']),
|
|
"--time_based",
|
|
"--runtime={0}".format(job['timeout']) ])
|
|
if job['s']:
|
|
if job['iops']:
|
|
ss = 'iops'
|
|
else:
|
|
ss = 'bw'
|
|
if job['slope']:
|
|
ss += "_slope"
|
|
ss += ":" + str(job['ss_limit'])
|
|
if job['pct']:
|
|
ss += '%'
|
|
parameters.extend([ '--ss_dur={0}'.format(job['ss_dur']),
|
|
'--ss={0}'.format(ss),
|
|
'--ss_ramp={0}'.format(job['ss_ramp']) ])
|
|
|
|
output = subprocess.call([args.fio] + parameters)
|
|
with open(tf, 'r') as source:
|
|
jsondata = json.loads(source.read())
|
|
os.remove(tf)
|
|
|
|
for jsonjob in jsondata['jobs']:
|
|
line = "job {0}".format(jsonjob['job options']['name'])
|
|
if job['s']:
|
|
if jsonjob['steadystate']['attained'] == 1:
|
|
# check runtime >= ss_dur + ss_ramp, check criterion, check criterion < limit
|
|
mintime = (job['ss_dur'] + job['ss_ramp']) * 1000
|
|
actual = jsonjob['read']['runtime']
|
|
if mintime > actual:
|
|
line = 'FAILED ' + line + ' ss attained, runtime {0} < ss_dur {1} + ss_ramp {2}'.format(actual, job['ss_dur'], job['ss_ramp'])
|
|
else:
|
|
line = line + ' ss attained, runtime {0} > ss_dur {1} + ss_ramp {2},'.format(actual, job['ss_dur'], job['ss_ramp'])
|
|
objsame, met, mean, target = check(data=jsonjob['steadystate']['data'],
|
|
iops=job['iops'],
|
|
slope=job['slope'],
|
|
pct=job['pct'],
|
|
limit=job['ss_limit'],
|
|
dur=job['ss_dur'],
|
|
criterion=jsonjob['steadystate']['criterion'])
|
|
if not objsame:
|
|
line = 'FAILED ' + line + ' fio criterion {0} != calculated criterion {1} '.format(jsonjob['steadystate']['criterion'], target)
|
|
else:
|
|
if met:
|
|
line = 'PASSED ' + line + ' target {0} < limit {1}'.format(target, job['ss_limit'])
|
|
else:
|
|
line = 'FAILED ' + line + ' target {0} < limit {1} but fio reports ss not attained '.format(target, job['ss_limit'])
|
|
else:
|
|
# check runtime, confirm criterion calculation, and confirm that criterion was not met
|
|
expected = job['timeout'] * 1000
|
|
actual = jsonjob['read']['runtime']
|
|
if abs(expected - actual) > 10:
|
|
line = 'FAILED ' + line + ' ss not attained, expected runtime {0} != actual runtime {1}'.format(expected, actual)
|
|
else:
|
|
line = line + ' ss not attained, runtime {0} != ss_dur {1} + ss_ramp {2},'.format(actual, job['ss_dur'], job['ss_ramp'])
|
|
objsame, met, mean, target = check(data=jsonjob['steadystate']['data'],
|
|
iops=job['iops'],
|
|
slope=job['slope'],
|
|
pct=job['pct'],
|
|
limit=job['ss_limit'],
|
|
dur=job['ss_dur'],
|
|
criterion=jsonjob['steadystate']['criterion'])
|
|
if not objsame:
|
|
if actual > (job['ss_dur'] + job['ss_ramp'])*1000:
|
|
line = 'FAILED ' + line + ' fio criterion {0} != calculated criterion {1} '.format(jsonjob['steadystate']['criterion'], target)
|
|
else:
|
|
line = 'PASSED ' + line + ' fio criterion {0} == 0.0 since ss_dur + ss_ramp has not elapsed '.format(jsonjob['steadystate']['criterion'])
|
|
else:
|
|
if met:
|
|
line = 'FAILED ' + line + ' target {0} < threshold {1} but fio reports ss not attained '.format(target, job['ss_limit'])
|
|
else:
|
|
line = 'PASSED ' + line + ' criterion {0} > threshold {1}'.format(target, job['ss_limit'])
|
|
else:
|
|
expected = job['timeout'] * 1000
|
|
actual = jsonjob['read']['runtime']
|
|
if abs(expected - actual) < 10:
|
|
result = 'PASSED '
|
|
else:
|
|
result = 'FAILED '
|
|
line = result + line + ' no ss, expected runtime {0} ~= actual runtime {1}'.format(expected, actual)
|
|
print line
|
|
if 'steadystate' in jsonjob:
|
|
pp.pprint(jsonjob['steadystate'])
|
|
jobnum += 1
|