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 <maryam.tahhan@intel.com>
Reviewed-by: Brian Castelli <brian.castelli@spirent.com>
Reviewed-by: Al Morton <acmorton@att.com>
Reviewed-by: Martin Klozik <martinx.klozik@intel.com>

diff --git a/tools/report/report_rst.jinja b/tools/report/report_rst.jinja
index 86008d1..7f513fc 100644 (file)
--- a/tools/report/report_rst.jinja
+++ b/tools/report/report_rst.jinja
@@ -77,6 +77,12 @@ 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.