diff options
-rw-r--r-- | docs/yardstick/opnfv_yardstick_tc010.rst | 65 | ||||
-rw-r--r-- | tests/opnfv/test_cases/opnfv_yardstick_tc010.yaml | 38 |
2 files changed, 103 insertions, 0 deletions
diff --git a/docs/yardstick/opnfv_yardstick_tc010.rst b/docs/yardstick/opnfv_yardstick_tc010.rst new file mode 100644 index 000000000..c2f8eb4e2 --- /dev/null +++ b/docs/yardstick/opnfv_yardstick_tc010.rst @@ -0,0 +1,65 @@ + +************************************* +Yardstick Test Case Description TC010 +************************************* ++-----------------------------------------------------------------------------+ +|Memory Latency | ++==============+==============================================================+ +|test case id | OPNFV_YARDSTICK_TC010_Memory Latency | ++--------------+--------------------------------------------------------------+ +|metric | Latency in nanoseconds | ++--------------+--------------------------------------------------------------+ +|test purpose | Measure the memory read latency for varying memory sizes and | +| | strides. Whole memory hierarchy is measured including all | +| | levels of cache. | ++--------------+--------------------------------------------------------------+ +|configuration | File: opnfv_yardstick_tc010.yaml | +| | | +| | * SLA (max_latency): 30 nanoseconds | +| | * Stride - 128 bytes | +| | * Stop size - 64 megabytes | +| | * Iterations: 10 - test is run 10 times iteratively. | +| | * Interval: 1 - there is 1 second delay between each | +| | iteration. | ++--------------+--------------------------------------------------------------+ +|test tool | Lmbench | +| | | +| | Lmbench is a suite of operating system microbenchmarks. This | +| | test uses lat_mem_rd tool from that suite. | +| | Lmbench is not always part of a Linux distribution, hence it | +| | needs to be installed in the test image | +| | (See :ref:`guest-image` for how to generate a Linux image | +| | for Glance with Lmbench included). | ++--------------+--------------------------------------------------------------+ +|references |* http://manpages.ubuntu.com/manpages/trusty/lat_mem_rd.8.html| +| | | +| |* McVoy, Larry W., and Carl Staelin. "lmbench: Portable Tools | +| | for Performance Analysis." *USENIX annual technical | +| | conference*. 1996. | ++--------------+--------------------------------------------------------------+ +|applicability | Test can be configured with different | +| | * strides; | +| | * stop_size; | +| | * iterations and intervals; | +| | | +| | There are default values for each above-mentioned option. | +| | | +| | * SLA (optional). | +| | max_latency: The maximum memory latency that is | +| | accepted. | ++--------------+--------------------------------------------------------------+ +|pre-test | The test case image needs to be installed into Glance | +|conditions | with Lmbench included in the image. | +| | | +| | No POD specific requirements have been identified. | ++--------------+------+----------------------------------+--------------------+ +|test sequence | step | description | result | +| +------+----------------------------------+--------------------+ +| | 1 | The host is installed as client. | Logs are stored | +| | | Lmbench's lat_mem_rd tool is | | +| | | invoked and logs are produced and| | +| | | stored. | | ++--------------+------+----------------------------------+--------------------+ +|test verdict | Test fails if the measured memory latency is above the SLA | +| | value or if there is a test case execution problem. | ++--------------+--------------------------------------------------------------+ diff --git a/tests/opnfv/test_cases/opnfv_yardstick_tc010.yaml b/tests/opnfv/test_cases/opnfv_yardstick_tc010.yaml new file mode 100644 index 000000000..42327f05f --- /dev/null +++ b/tests/opnfv/test_cases/opnfv_yardstick_tc010.yaml @@ -0,0 +1,38 @@ +--- +# Yardstick TC010 config file +# measure memory read latency using lmbench + +schema: "yardstick:task:0.1" + +scenarios: +- + type: Lmbench + options: + test_type: "latency" + stride: 128 + stop_size: 64.0 + + host: demeter.yardstick-TC010 + + runner: + type: Iteration + iterations: 10 + interval: 1 + + sla: + max_latency: 30 + action: monitor + +context: + name: yardstick-TC010 + image: yardstick-trusty-server + flavor: m1.small + user: ec2-user + + servers: + demeter: + floating_ip: true + + networks: + test: + cidr: '10.0.1.0/24' |