From 669b2d855e0224a1a334bc6489962399ef37efac Mon Sep 17 00:00:00 2001 From: Maryam Tahhan Date: Thu, 28 Jan 2016 20:00:11 +0000 Subject: docs: Add a note on pidstat and unknown results. Add a Note on why %CPU and %USER > 100%, as well as a note regarding the "unkown" results. Change-Id: I7e173c91a549932301645c9344648c9b73da4a70 Signed-off-by: Maryam Tahhan Reviewed-by: Brian Castelli Reviewed-by: Al Morton Reviewed-by: Martin Klozik --- tools/report/report_rst.jinja | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/tools/report/report_rst.jinja b/tools/report/report_rst.jinja index 4b5c9c37..7f513fc4 100644 --- a/tools/report/report_rst.jinja +++ b/tools/report/report_rst.jinja @@ -38,7 +38,7 @@ Below are test details: {% for test in tests %} Test results for packet size: {{ "%s"|format(test.result['packet_size']) }} -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ A detailed summary of the main results is outlined below. Results/Metrics Collected @@ -72,10 +72,17 @@ Process: {{ '_'.join(process.split('_')[:-1]) }} {% endfor %}{% endfor %} Anomalies -~~~~~~~~~ +~~~~~~~~~~ No anomalies were detected during the course of this test. Testing Activities/Events ~~~~~~~~~~~~~~~~~~~~~~~~~ -There were no significant testing activities for this test. +pidstat is used to collect the process statistics, as such some values such as +%CPU and %USER maybe > 100% as the values are summed across multiple cores. For +more info on pidstat please see: http://linux.die.net/man/1/pidstat. +Known issues: Some reported metrics have the value "unkown". These values are +marked unknown as they are not values retrieved from the external tester +(traffic generator). They were incorrectly derived in a way that made assumptions +about packet sizes, as such they have been deprecated from vsperf and marked as +unknown. They will be resolved in the next release. -- cgit 1.2.3-korg