1 ##############################################################################
2 # Copyright (c) 2015 Ericsson AB and others.
4 # All rights reserved. This program and the accompanying materials
5 # are made available under the terms of the Apache License, Version 2.0
6 # which accompanies this distribution, and is available at
7 # http://www.apache.org/licenses/LICENSE-2.0
8 ##############################################################################
13 import yardstick.ssh as ssh
14 from yardstick.benchmark.scenarios import base
16 LOG = logging.getLogger(__name__)
19 class Lmbench(base.Scenario):
20 """Execute lmbench memory read latency or memory bandwidth benchmark in a host
23 test_type - specifies whether to measure memory latency or bandwidth
28 Parameters for memory read latency benchmark
29 stride - number of locations in memory between starts of array elements
33 stop_size - maximum array size to test (minimum value is 0.000512)
38 Results are accurate to the ~2-5 nanosecond range.
40 Parameters for memory bandwidth benchmark
41 size - the amount of memory to test
45 benchmark - the name of the memory bandwidth benchmark test to execute.
46 Valid test names are rd, wr, rdwr, cp, frd, fwr, fcp, bzero, bcopy
50 warmup - the number of repetitons to perform before taking measurements
54 more info http://manpages.ubuntu.com/manpages/trusty/lmbench.8.html
56 __scenario_type__ = "Lmbench"
58 LATENCY_BENCHMARK_SCRIPT = "lmbench_latency_benchmark.bash"
59 BANDWIDTH_BENCHMARK_SCRIPT = "lmbench_bandwidth_benchmark.bash"
60 LATENCY_CACHE_SCRIPT = "lmbench_latency_for_cache.bash"
62 def __init__(self, scenario_cfg, context_cfg):
63 self.scenario_cfg = scenario_cfg
64 self.context_cfg = context_cfg
65 self.setup_done = False
69 self.bandwidth_target_script = pkg_resources.resource_filename(
70 "yardstick.benchmark.scenarios.compute",
71 Lmbench.BANDWIDTH_BENCHMARK_SCRIPT)
72 self.latency_target_script = pkg_resources.resource_filename(
73 "yardstick.benchmark.scenarios.compute",
74 Lmbench.LATENCY_BENCHMARK_SCRIPT)
75 self.latency_for_cache_script = pkg_resources.resource_filename(
76 "yardstick.benchmark.scenarios.compute",
77 Lmbench.LATENCY_CACHE_SCRIPT)
78 host = self.context_cfg["host"]
79 user = host.get("user", "ubuntu")
80 ssh_port = host.get("ssh_port", ssh.DEFAULT_PORT)
81 ip = host.get("ip", None)
82 key_filename = host.get('key_filename', "~/.ssh/id_rsa")
84 LOG.info("user:%s, host:%s", user, ip)
85 self.client = ssh.SSH(user, ip, key_filename=key_filename,
87 self.client.wait(timeout=600)
89 # copy scripts to host
90 self.client.run("cat > ~/lmbench_latency.sh",
91 stdin=open(self.latency_target_script, 'rb'))
92 self.client.run("cat > ~/lmbench_bandwidth.sh",
93 stdin=open(self.bandwidth_target_script, 'rb'))
94 self.client.run("cat > ~/lmbench_latency_for_cache.sh",
95 stdin=open(self.latency_for_cache_script, 'rb'))
96 self.setup_done = True
98 def run(self, result):
99 """execute the benchmark"""
101 if not self.setup_done:
104 options = self.scenario_cfg['options']
105 test_type = options.get('test_type', 'latency')
107 if test_type == 'latency':
108 stride = options.get('stride', 128)
109 stop_size = options.get('stop_size', 16.0)
110 cmd = "sudo bash lmbench_latency.sh %f %d" % (stop_size, stride)
111 elif test_type == 'bandwidth':
112 size = options.get('size', 128)
113 benchmark = options.get('benchmark', 'rd')
114 warmup_repetitions = options.get('warmup', 0)
115 cmd = "sudo bash lmbench_bandwidth.sh %d %s %d" % \
116 (size, benchmark, warmup_repetitions)
117 elif test_type == 'latency_for_cache':
118 repetition = options.get('repetition', 1)
119 warmup = options.get('warmup', 0)
120 cmd = "sudo bash lmbench_latency_for_cache.sh %d %d" % \
123 raise RuntimeError("No such test_type: %s for Lmbench scenario",
126 LOG.debug("Executing command: %s", cmd)
127 status, stdout, stderr = self.client.execute(cmd)
130 raise RuntimeError(stderr)
132 if test_type == 'latency':
133 result.update({"latencies": json.loads(stdout)})
135 result.update(json.loads(stdout))
137 if "sla" in self.scenario_cfg:
139 if test_type == 'latency':
140 sla_max_latency = int(self.scenario_cfg['sla']['max_latency'])
141 for t_latency in result["latencies"]:
142 latency = t_latency['latency']
143 if latency > sla_max_latency:
144 sla_error += "latency %f > sla:max_latency(%f); " \
145 % (latency, sla_max_latency)
146 elif test_type == 'bandwidth':
147 sla_min_bw = int(self.scenario_cfg['sla']['min_bandwidth'])
148 bw = result["bandwidth(MBps)"]
150 sla_error += "bandwidth %f < " \
151 "sla:min_bandwidth(%f)" % (bw, sla_min_bw)
152 elif test_type == 'latency_for_cache':
153 sla_latency = float(self.scenario_cfg['sla']['max_latency'])
154 cache_latency = float(result['L1cache'])
155 if sla_latency < cache_latency:
156 sla_error += "latency %f > sla:max_latency(%f); " \
157 % (cache_latency, sla_latency)
158 assert sla_error == "", sla_error
162 """internal test function"""
163 key_filename = pkg_resources.resource_filename('yardstick.resources',
164 'files/yardstick_key')
167 'ip': '10.229.47.137',
169 'key_filename': key_filename
173 logger = logging.getLogger('yardstick')
174 logger.setLevel(logging.DEBUG)
177 'test_type': 'latency',
182 sla = {'max_latency': 35, 'action': 'monitor'}
183 args = {'options': options, 'sla': sla}
186 p = Lmbench(args, ctx)
190 if __name__ == '__main__':