5d9c24d574
Small updates to the README, including adding instructions on how to generate a `config.json` using stackviz-export and local subunit+dstat files. Also includes a link to the upstream planning etherpad, which will be used for ideas about getting StackViz working with data from devstack-gate runs. Change-Id: I206cb5ea6331eaf005b8c9c43a1e7b93e2d77a92
69 lines
2.2 KiB
ReStructuredText
69 lines
2.2 KiB
ReStructuredText
=================
|
|
StackViz: Angular
|
|
=================
|
|
A visualization utility to help analyze the performance of DevStack setup and
|
|
Tempest executions.
|
|
|
|
Installation
|
|
============
|
|
Installation of the frontend requires Node.js and Gulp. On Ubuntu::
|
|
|
|
sudo apt-get install nodejs npm nodejs-legacy
|
|
sudo npm install -g gulp
|
|
|
|
Then, install the Node modules by running, from the project directory::
|
|
|
|
npm install
|
|
|
|
Usage - Development
|
|
===================
|
|
A development server can be run as follows::
|
|
|
|
gulp dev
|
|
|
|
This will open a web browser and reload code automatically as it changes on the
|
|
filesystem.
|
|
|
|
If you have subunit and dstat logs, you can create a config.json to display
|
|
your runs::
|
|
|
|
stackviz-export -f <path/to/subunit> --dstat <path/to/dstat> app/data/
|
|
|
|
|
|
Usage - Production
|
|
==================
|
|
The production application can be build using::
|
|
|
|
gulp prod
|
|
|
|
The result will be written to :code:`./build` and should be appropriate for
|
|
distribution. Note that all files are not required:
|
|
|
|
- Directory structure (:code:`js/`, :code:`css/`, :code:`fonts/`,
|
|
:code:`images/`): required.
|
|
- Static resources (:code:`fonts/`, :code:`images/`): required.
|
|
- Core files (:code:`index.html`, :code:`js/main.js`, :code:`css/main.css`):
|
|
required unless gzipped versions are used.
|
|
- Gzipped versions of core files (:code:`*.gz`): not required, but preferred.
|
|
Use instead of plain core files to save on disk usage and bandwidth.
|
|
- Source maps (:code:`js/main.js.map`, :code:`js/main.js.map.gz`): only required
|
|
for debugging purposes.
|
|
|
|
Roadmap
|
|
=======
|
|
- Project split: All server-side components will be removed, and replaced with
|
|
specialized data transformation tools.
|
|
|
|
- Data sources and processing: `stackviz` Python project, with
|
|
`stackviz-export` used to generate JSON data files and configuration.
|
|
|
|
- Web interface:
|
|
|
|
- Will remain in this namespace (:code:`openstack-qa/stackviz`).
|
|
- Will decouple data processing from build process, allowing for
|
|
distribution to nodes as a prebuilt static site.
|
|
- Data sources will be configured in a :code:`config.json`.
|
|
- Will support local and remote sources via REST/JSONP (pending API spec).
|
|
|
|
- Upstream Implementation: https://etherpad.openstack.org/p/BKgWlKIjgQ
|