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