1#!/bin/ksh
2
3#
4# This file and its contents are supplied under the terms of the
5# Common Development and Distribution License ("CDDL"), version 1.0.
6# You may only use this file in accordance with the terms of version
7# 1.0 of the CDDL.
8#
9# A full copy of the text of the CDDL should have accompanied this
10# source.  A copy of the CDDL is also available via the Internet at
11# http://www.illumos.org/license/CDDL.
12#
13
14#
15# Copyright (c) 2015, 2021 by Delphix. All rights reserved.
16#
17
18#
19# Description:
20# Trigger fio runs using the random_reads job file. The number of runs and
21# data collected is determined by the PERF_* variables. See do_fio_run for
22# details about these variables.
23#
24# The files to read from are created prior to the first fio run, and used
25# for all fio runs. The ARC is cleared with `zinject -a` prior to each run
26# so reads will go to disk.
27#
28# Thread/Concurrency settings:
29#    PERF_NTHREADS defines the number of files created in the test filesystem,
30#    as well as the number of threads that will simultaneously drive IO to
31#    those files.  The settings chosen are from measurements in the
32#    PerfAutoESX/ZFSPerfESX Environments, selected at concurrency levels that
33#    are at peak throughput but lowest latency.  Higher concurrency introduces
34#    queue time latency and would reduce the impact of code-induced performance
35#    regressions.
36#
37
38. $STF_SUITE/include/libtest.shlib
39. $STF_SUITE/tests/perf/perf.shlib
40
41command -v fio > /dev/null || log_unsupported "fio missing"
42
43function cleanup
44{
45	# kill fio and iostat
46	pkill fio
47	pkill iostat
48	recreate_perf_pool
49}
50
51trap "log_fail \"Measure IO stats during random read load\"" SIGTERM
52log_onexit cleanup
53
54recreate_perf_pool
55populate_perf_filesystems
56
57# Aim to fill the pool to 50% capacity while accounting for a 3x compressratio.
58export TOTAL_SIZE=$(($(get_prop avail $PERFPOOL) * 3 / 2))
59
60# Variables specific to this test for use by fio.
61export PERF_NTHREADS=${PERF_NTHREADS:-'16 32'}
62export PERF_NTHREADS_PER_FS=${PERF_NTHREADS_PER_FS:-'0'}
63export PERF_IOSIZES=${PERF_IOSIZES:-'8k'}
64export PERF_SYNC_TYPES=${PERF_SYNC_TYPES:-'1'}
65
66# Layout the files to be used by the read tests. Create as many files as the
67# largest number of threads. An fio run with fewer threads will use a subset
68# of the available files.
69export NUMJOBS=$(get_max $PERF_NTHREADS)
70export FILE_SIZE=$((TOTAL_SIZE / NUMJOBS))
71export DIRECTORY=$(get_directory)
72log_must fio $FIO_SCRIPTS/mkfiles.fio
73
74# Set up the scripts and output files that will log performance data.
75lun_list=$(pool_to_lun_list $PERFPOOL)
76log_note "Collecting backend IO stats with lun list $lun_list"
77if is_linux; then
78	typeset perf_record_cmd="perf record -F 99 -a -g -q \
79	    -o /dev/stdout -- sleep ${PERF_RUNTIME}"
80
81        export collect_scripts=(
82	    "zpool iostat -lpvyL $PERFPOOL 1" "zpool.iostat"
83	    "vmstat -t 1" "vmstat"
84	    "mpstat -P ALL 1" "mpstat"
85	    "iostat -tdxyz 1" "iostat"
86	    "$perf_record_cmd" "perf"
87	)
88else
89	export collect_scripts=(
90	    "$PERF_SCRIPTS/io.d $PERFPOOL $lun_list 1" "io"
91	    "vmstat -T d 1" "vmstat"
92	    "mpstat -T d 1" "mpstat"
93	    "iostat -T d -xcnz 1" "iostat"
94	)
95fi
96
97log_note "Random reads with settings: $(print_perf_settings)"
98do_fio_run random_reads.fio false true
99log_pass "Measure IO stats during random read load"
100