Google Git
Sign in
gerrit / plugins / analytics-wizard / afedce0a97fd1b80bbf7b587bd8664b983bb3773
commitafedce0a97fd1b80bbf7b587bd8664b983bb3773[log] [tgz]
authorAntonio Barone <syntonyze@gmail.com>Fri Nov 16 14:09:02 2018 -0800
committerAntonio Barone <syntonyze@gmail.com>Tue Nov 20 11:00:41 2018 +0000
tree8c25ecabea0dc42da3f8b464425426a23aa89d9f
parent24ffd6c451390e53efa5ee655c4b458a88a4dbc9 [diff]
Avoid starting docker before docker-compose exists

Fixed a bug whereby ajax callbacks were executed immediately
rather than deferred at ajax result time by wrapping actual
execution functions with anonymous callbacks.

Bug: Issue 10053
Change-Id: I3d4685fb169f0678d7fe7822c4b86c4e0f3f5658
1 file changed
tree: 8c25ecabea0dc42da3f8b464425426a23aa89d9f
  1. project/
  2. resources/
  3. src/
  4. .gitignore
  5. .scalafmt.conf
  6. build.sbt
  7. LICENSE
  8. README.md
README.md

Analytics Wizard plugin

Wizard to locally setup an Analytics Dashboard like the Gerrit's one. This will allow you to explore the potentials of DevOps Analytics on your own repositories.

What it DOES

  • Setup a ready to use Analytics Dashboard with some defaults charts
  • Populate the Dashboard with data coming from the repos you would like to analyse

What it DOES NOT

  • Schedule recurring import of the data, but just the first one
  • Create a production ready environment. It is meant to build a playground to explore the potential of DevOps analytics
  • Create multiple dashboards

Setup

Prerequisites

##Installation

Copy the latest available jar into the Gerrit plugins directory and restart it. Assuming /usr/local/gerrit is the location of your Gerrit installation simply execute the following:

curl -o /tmp/analytics-wizard.jar https://gerrit-ci.gerritforge.com/job/plugin-analytics-wizard-sbt-master-master/analytics-wizard.jar &&\
cp /tmp/analytics-wizard.jar /usr/local/gerrit/plugins

How to use it

Once you are logged in Gerrit you can access the dashboard configuration via the top menu (Analytics Wizard > Configure Dashboard).

You will land on this screen:

alt text

Different parameters can be configured:

  • Dashboard name (required): name of the dashboard you are about to create
  • Projects prefix (optional): prefix of the projects you want to import, i.e.: to import all the projects under the Gerrit namespace, you can specify gerrit/. Note: It is not a regular expression.
  • Aggregation type (required): the data can be aggregated by email only, by email per hour, by email per day, by email per month or by email per year.
  • Date time-frame (optional): time window you want to collect data about
  • Username/Password (optional): credentials for Gerrit API, if basic auth is needed

Once you set the parameters pressing the “Create Dashboard” button will trigger the Dashboard creation and the data import.

Beware this operation will take a while since it requires to download several Docker images and run an ETL job to collect and aggregate the data.

At the end of this operation you will be presented with a dashbaord similar to this one:

alt text

You can now navigate among the different charts and uncover the potentials of DevOps analytics!

Components interaction

alt text

Development

To build the plugin, JDK 1.8 and sbt are required. Once installed use sbt to build:

cd ./analytics-wizard
sbt assembly

This will compile, test and package the plugin artifact, which can be found in ./target/scala-2.11/analytics-wizard.jar.

Caveats

  • Virtual Memory settings: run sysctl -w vm.max_map_count=262144 from command line, if you are using a Linux box and the dashboard creation fails with a similar error:
max virtual memory areas vm.max_map_count [XXXXX] is too low, increase to at least [262144]