From ca0ac9f560d1887ccde7b4d1efbb92e4c0dece01 Mon Sep 17 00:00:00 2001 From: saksham115 Date: Wed, 13 Sep 2017 07:23:16 +0530 Subject: Documentation for storperf-reporting module JIRA: STORPERF-141 Change-Id: I3a228737093d7ea3b645789fb2c7569ed4e932d5 Signed-off-by: saksham115 --- docs/index.rst | 1 + docs/testing/user/demo_example.png | Bin 0 -> 48885 bytes docs/testing/user/graph_explanation.png | Bin 0 -> 47744 bytes docs/testing/user/index.rst | 1 + docs/testing/user/storperf-reporting.rst | 96 +++++++++++++++++++++++++++++++ 5 files changed, 98 insertions(+) create mode 100644 docs/testing/user/demo_example.png create mode 100644 docs/testing/user/graph_explanation.png create mode 100644 docs/testing/user/storperf-reporting.rst diff --git a/docs/index.rst b/docs/index.rst index 9729a44..0876a56 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -36,6 +36,7 @@ StorPerf User Guide ./testing/user/introduction.rst ./testing/user/test-usage.rst + ./testing/user/storperf-reporting.rst Indices diff --git a/docs/testing/user/demo_example.png b/docs/testing/user/demo_example.png new file mode 100644 index 0000000..248d293 Binary files /dev/null and b/docs/testing/user/demo_example.png differ diff --git a/docs/testing/user/graph_explanation.png b/docs/testing/user/graph_explanation.png new file mode 100644 index 0000000..be62144 Binary files /dev/null and b/docs/testing/user/graph_explanation.png differ diff --git a/docs/testing/user/index.rst b/docs/testing/user/index.rst index e9054dc..1f4a6cd 100644 --- a/docs/testing/user/index.rst +++ b/docs/testing/user/index.rst @@ -15,3 +15,4 @@ StorPerf User Guide introduction.rst installation.rst test-usage.rst + storperf-reporting.rst diff --git a/docs/testing/user/storperf-reporting.rst b/docs/testing/user/storperf-reporting.rst new file mode 100644 index 0000000..4094829 --- /dev/null +++ b/docs/testing/user/storperf-reporting.rst @@ -0,0 +1,96 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) OPNFV, Dell EMC and others. + +========================== +Storperf Reporting Module +========================== + + +About this project +===================== + +* This project aims to create a series of graphs to support the SNIA reports. +* All data for the reports can be fetched either from the OPNFV Test Results DB, or locally from StorPerf's own database of current run data. +* The report code may be stored in either the Releng repository (so it can be included in the Test Results Dashboards), or locally in StorPerf's own git repository. +* The report (generated by the reporting module) looks like the following example: + +.. image:: demo_example.png + :align: center + +Usage +======= + +* Enter the URL for the location of the data for which you want to generate the report. +* Note: You can test the module using the testdata present in the directory ``storperf-reporting/src/static/testdata``. Instead of the URL enter the filename present in the testdata directory, eg. **local-data.json** +* After entering the URL, you are taken to the page showing the details of the all the jobs present in the data. +* Click on the *Click here to view details* to see the different block sizes for the respective job. +* Click on the block size and select the parameter for which you want to view the graph. + +Graph Explanation +=================== + +Example of a graph generated is shown below:- + + +.. image:: graph_explanation.png + :align: center + +**Steady State Convergence Graph** + +* This graph shows the values as reported by StorPerf for the actual and average throughput. +* Also shown is the average +-10% and the slope. +* It serves to visually demonstrate the compliance to the steady state definition. +* The allowed maximum data excursion is 20% of the average (or average x 0.20) +* The allowed maximum slope excursion is 10% of the average. +* The measured data excursion is the value from range. +* The measured slope excursion is the value from range + +Workflow +========== + +A Flask server is used to fetch the data and is sent to the client side for formation of the graphs (Using Javascript). + +Steps involved +-------------- + +* Step 1: Data is fetched from the OPNFV Test Results ReST API +* Step 2: The fields "report_data" and "metrics" are taken from the JSON object retrieved in the above step and sent to the client side. +* Step 3: The "report_data" is obtained by the client side and a parser written in Javascript along with Plotly.js forms the graphs. + +Directory structure +==================== + +``storperf/docker/storperf-reporting/`` contains the code used for this project. + +The file structure is as follows:- + +.. code-block:: bash + + storperf-reporting + |+-- Dockerfile # Dockerfile for the storperf-reporting container + |+-- requirements.txt # pip requirements for the container + +-- src # Contains the code for the flask server + |+-- app.py # Code to run the flask application + |+-- static # Contains the static files (js,css) + | |+-- css # Contains css files + | | `-- bootstrap.min.css + | |+-- images + | |+-- js # Contains the javascript files + | | |-- bootstrap.min.js + | | |-- Chart.min.js + | | |-- jquery-2.1.3.min.js + | | |-- jquery.bootpag.min.js + | | `-- plotly-latest.min.js # Used for plotting the graphs + | `-- testdata # Contains testing data for the module + `-- templates + |-- index.html + |-- plot_jobs.html + |-- plot_multi_data.html + `-- plot_tables.html + +Graphing libraries and tools +============================== + +* Plotly.js is used as the graphing library for this project (Link: https://plot.ly/javascript/) +* Bootstrap is used for the UI of the project. -- cgit 1.2.3-korg