From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id D5C0DA0508; Wed, 6 Apr 2022 17:13:54 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 92D4142914; Wed, 6 Apr 2022 17:11:40 +0200 (CEST) Received: from lb.pantheon.sk (lb.pantheon.sk [46.229.239.20]) by mails.dpdk.org (Postfix) with ESMTP id D9658428F0 for ; Wed, 6 Apr 2022 17:11:33 +0200 (CEST) Received: from localhost (localhost [127.0.0.1]) by lb.pantheon.sk (Postfix) with ESMTP id 44AFA129C28; Wed, 6 Apr 2022 17:11:33 +0200 (CEST) X-Virus-Scanned: amavisd-new at siecit.sk Received: from lb.pantheon.sk ([127.0.0.1]) by localhost (lb.pantheon.sk [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id S7TFSfaNUd2K; Wed, 6 Apr 2022 17:11:32 +0200 (CEST) Received: from entguard.lab.pantheon.local (unknown [46.229.239.141]) by lb.pantheon.sk (Postfix) with ESMTP id 8E884184FF8; Wed, 6 Apr 2022 17:11:16 +0200 (CEST) From: =?UTF-8?q?Juraj=20Linke=C5=A1?= To: thomas@monjalon.net, david.marchand@redhat.com, Honnappa.Nagarahalli@arm.com, ohilyard@iol.unh.edu, lijuan.tu@intel.com Cc: dev@dpdk.org, =?UTF-8?q?Juraj=20Linke=C5=A1?= Subject: [RFC PATCH v1 20/24] dts: merge DTS doc/dts_gsg/usr_guide/results.rst to DPDK Date: Wed, 6 Apr 2022 15:11:02 +0000 Message-Id: <20220406151106.2915304-21-juraj.linkes@pantheon.tech> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220406151106.2915304-1-juraj.linkes@pantheon.tech> References: <20220406151106.2915304-1-juraj.linkes@pantheon.tech> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org --- dts/doc/dts_gsg/usr_guide/results.rst | 101 ++++++++++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 dts/doc/dts_gsg/usr_guide/results.rst diff --git a/dts/doc/dts_gsg/usr_guide/results.rst b/dts/doc/dts_gsg/usr_guide/results.rst new file mode 100644 index 0000000000..3ec08d86fe --- /dev/null +++ b/dts/doc/dts_gsg/usr_guide/results.rst @@ -0,0 +1,101 @@ +Test Result +=========== + +Overview +-------- + +After DTS finished the validation, we can find the result files similar as below in output folder. + +.. code-block:: console + + rst_report dts.log statistics.txt TestHelloWorld.log test_results.json test_results.xls + +* rst_report: contains the result RST file of performance data +* dts.log: Full execution log of DTS framework +* statstics.txt: summary statistics of DTS executed suites +* TestHelloWorld.log: log message of Test suite: HelloWorld +* test_result.json: json format result file +* test_result.xls: excel format result file + +Statistics +---------- + +You can go through the summary of execution result via statistic.txt. This file includes the number of passed test cases, the number of failed case, the number of blocked and pass ratio. + +Please see example as the following. You can cat the sample file, then show this information of execution, totally executed two test cases, all cases passed the criterion and no failed or blocked cases. + +.. code-block:: console + + [root@tester output]# cat statistics.txt + dpdk_version = 21.02.0 + Passed = 2 + Failed = 0 + Blocked = 0 + Pass rate = 100.0 + +Details +------- + +DTS provides 2 formats for test results, one is json, and the other is excel. +If you need more detail information of test result, either of them is good to check. +Both of them contain case names and results, also the failure reasons. + +* JSON result: result.json + +.. code-block:: console + + { + "192.168.1.1": { + "dpdk_version": "21.02.0", + "nic": { + "driver": "vfio-pci", + "firmware": "8.00 0x80008c1a 1.2766.0", + "kdriver": "i40e-2.13.10", + "name": "fortville_25g" + }, + "x86_64-native-linuxapp-gcc": { + "hello_world/test_hello_world_all_core": "passed" + "hello_world/test_hello_world_single_core": "passed" + } + } + } + + +* Excel result: test_result.xls + +.. figure:: image/dts_result.png + +Logs +---- + +If you want to track more details about the process of each suite, please go to log file which named by this suite, all related information will stored in this file. + +Please see example for TestHelloWorld suite log as the following. This log file showed that application helloworld sent hello message from core1, and finally matched the pass criterion. + +.. code-block:: console + + 31/12/2020 11:04:00 INFO: + TEST SUITE : TestHelloWorld + 31/12/2020 11:04:00 INFO: NIC : fortville_25g + 31/12/2020 11:04:00 SUITE_DUT_CMD: meson configure -Dexamples=helloworld x86_64-native-linuxapp-gcc + 31/12/2020 11:04:01 SUITE_DUT_CMD: ninja -C x86_64-native-linuxapp-gcc + 31/12/2020 11:04:07 SUITE_DUT_OUTPUT: ninja: Entering directory `x86_64-native-linuxapp-gcc'^M + [0/1] Regenerating build files.^M + The Meson build system^M + Version: 0.55.3^M + Source dir: /root/dpdk^M + Build dir: /root/dpdk/x86_64-native-linuxapp-gcc^M + Build type: native build^ + … + Build targets in project: 998^M + Found ninja-1.10.0.git.kitware.jobserver-1 at /usr/local/bin/ninja^M + [1/2] Compiling C object examples/dpdk-helloworld.p/helloworld_main.c.o^M + [2/2] Linking target examples/dpdk-helloworld + 31/12/2020 11:04:09 INFO: Test Case test_hello_world_single_core Begin + 31/12/2020 11:04:13 SUITE_DUT_CMD: ./x86_64-native-linuxapp-gcc/examples/dpdk-helloworld -l 1 -n 4 --file-prefix=dpdk_10243_20201231110241 + SUITE_DUT_OUTPUT: EAL: Detected 72 lcore(s)^M + … + hello from core 1 + 31/12/2020 11:04:15 INFO: Test Case test_hello_world_single_core Result PASSED: + 31/12/2020 11:04:25 INFO: + TEST SUITE ENDED: TestHelloWorld -- 2.20.1