third-party-ci-tools/monitoring/lastcomment-scoreboard/README.rst

Last Comment

Last Comment is a small script to query OpenStack's gerrit REST API and produce a report about the status of CI systems.

This can also be used as a CLI tool and used against any type of user (human or bot).

Design

The html based report is a data file plus a static page.

lastcomment is powered by gerrit's REST API and doesn't use any datastore. Although this means it cannot show results in real time, the data can be refreshed as frequent as desired.

Dependencies

requests

Help

./lastcomment.py -h

Generate a Report

To generate a html report for third party CI accounts on http://localhost:8000/report:

./lastcomment.py -f ci.yaml -c 100 --json lastcomment.json python -m SimpleHTTPServer

Cloud-init

To run this on a cloud server using cloud-init and cron use the user-data.txt file.

Other Uses

To see the last time the user 'Third Party CI' commented anywhere

./lastcomment.py -n 'Third Party CI'

To print the last 30 comments by 'Third Party CI' on the repo openstack/cinder

./lastcomment.py -n 'Third Party CI' -m -p openstack/cinder

To print the last 30 votes by 'Third Party CI' on the repo openstack/cinder

./lastcomment.py -n 'Third Party CI' -v -p openstack/cinder

To print the contents of the last 30 reviews by 'John Smith'

./lastcomment.py -n 'John Smith' -m

To specify a yaml file names.yaml containing projects and names to iterate through

./lastcomment.py -f names.yaml

To print statistics on third party CI accounts:

./lastcomment.py -c 100 -f ci.yaml -v

To generate a html report for cinder's third party CI accounts on http://localhost:8000/report:

./lastcomment.py -f ci.yaml -c 100 --json lastcomment.json python -m SimpleHTTPServer

CI Reporter

Script that produces statistics and a report of CI systems and their jobs. It can output in plain text or json to stdout or a file.

Help

./cireporter.py -h

Generate A Report

To generate a plain text report that includes stats for all Cinder CI's

./cireporter.py -i cinder.yaml -c 250

Other Uses

To see the latest Cinder Jenkins stats

./cireporter.py -p openstack/cinder -n Jenkins -c 250

To generate a report as json output to stdout

./cireporter.py -p openstack/cinder -n Jenkins -c 250 -j

To generate a report as json and write it to a file

./cireporter.py -p openstack/cinder -n Jenkins -c 250 -j -o foo.json