Hi everybody,

The Analytics Team is happy to announce the first version of gerrit-stats.
Gerrit-stats keeps track of the backlog of codereview for Git individual
repositories.

Gerrit-stats dashboard is available at http://gerrit-stats.wmflabs.org
Currently, it has a few example charts but we can add your repo to the
dashboard as well, just let us know!

To create a new chart yourself visit
http://gerrit-stats.wmflabs.org/graphs/new
This will launch the interface to create your own graph. Click on 'Data'
and  Click on 'Add Metric' and a pull down menu with all the repositories
will appear. Select the repository of your interest and select the metric
that you want to visualize. Once you have selected all the metrics of your
interest go back to 'Info' and enter a slug name. Then press 'Enter' and
then click the 'Save' button.

Currently, the following metrics are tracked (on a daily basis):
1) Number of new changesets
2) Number of changesets without any codereview per day (this excludes
automated review from lint and lint-like reviewers).
3) Number of changesets waiting for merge per day (only applies to
changesets that received only positive reviews)
4) Number of changesets self reviewed.

And for metrics 2 and 3, there is a version for volunteers and for WMF
staff.


Gerrit-stats is visualized using Limn, Limn is the data GUI developed by
the Analytics Team and lead by David Schoonover. Limn is available on
https://github.com/wikimedia/limn

This is the initial release and I am sure there will be bugs and issues. If
you have any questions, or problems using gerrit-stats then either:
1) Head over to #wikimedia-analytics on IRC and ask us
2) Send an email to the analytics mailinglist
3) Contact us directly.


Not Yet Frequently Asked Questions:

1) How do I create a visualization of the code review metrics for a repo?

Visit gerrit-stats.wmflabs.org/graphs/new

This will launch the interface to create your own graph. Click on 'Data'
and  Click on 'Add Metric'  and a pull down menu with all the repositories
will appear.  Select the repository of your interest and select the metric
that you want to visualize. Once you have selected all the metrics of your
interest press the 'Save' button.
Your are all set and you can use this permalink for future reference.

2) How do I edit an existing chart?
Simply append /edit to the URL of your chart and you can edit it.

3) My repository is not showing up in the pull down menu, what happened?
By default, all repositories are automagically kept track of as soon they
contain a single commit. There are two exceptions:
1) If your repository name contains the string 'test' or 'private', it will
be ignored.
2) The orgchart repository is not tracked by gerrit-stats, this is a known
issue but Chad and I haven't been able to figure out what causes this.

If your repository is missing then please contact me.

4) Will you add metrics for individual committers?
Right now, the unit of analysis is a repository but it is definitely
possible to keep track of codereview  metrics for individuals. However, I
would like to hear some use-cases first before embarking on this.

5) The chart looks to spikey, how can I have smoother lines?
1) Go to http://gerrit-stats.wmflabs.org/graphs/name_of_chart/edit
2) Click on 'Options'
3) Click on 'Advanced' (right side of screen)
4) Click on 'rollPeriod' (bottom of screen, yellow box)
5) This allows to create a moving average, so you can replace the 1 with 7
meaning that each datapoint is the average of the past 7 days. This option
applies to both metrics but it really smooths out the outliers.

6) I want a new metric. How do I go about it?
There are two options:
a) Clone the gerrit-stats repo and hack away,it's Python btw. We are happy
to help out!
b) Send us a suggestion for a new metric, the more precise the more useful!

On behalf of the Analytics Team,

Diederik
_______________________________________________
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l

Reply via email to