https://github.com/jenkinsci/build-monitor-plugin
Jenkins Build Monitor Plugin
https://github.com/jenkinsci/build-monitor-plugin
continuous-delivery continuous-improvement continuous-integration continuous-testing jenkins-ci
Last synced: 29 days ago
JSON representation
Jenkins Build Monitor Plugin
- Host: GitHub
- URL: https://github.com/jenkinsci/build-monitor-plugin
- Owner: jenkinsci
- License: mit
- Created: 2013-07-06T11:39:57.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2025-04-07T08:55:53.000Z (about 1 month ago)
- Last Synced: 2025-04-13T16:06:15.342Z (29 days ago)
- Topics: continuous-delivery, continuous-improvement, continuous-integration, continuous-testing, jenkins-ci
- Language: Java
- Homepage: https://plugins.jenkins.io/build-monitor-plugin/
- Size: 19 MB
- Stars: 726
- Watchers: 41
- Forks: 282
- Open Issues: 161
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Jenkins CI Build Monitor Plugin
[](https://ci.jenkins.io/job/Plugins/job/build-monitor-plugin/job/master/)
[](https://plugins.jenkins.io/build-monitor-plugin)
[](https://plugins.jenkins.io/build-monitor-plugin)
Build Monitor Plugin provides a highly visible view of the status of selected Jenkins jobs.
It easily accommodates different computer screen sizes and is ideal as an Extreme Feedback Device to be displayed on a screen on your office wall.
Have a question? Perhaps it's already been answered - check the [FAQ](#faq) section below.
## Features
* Displays the status and progress of selected jobs. The view is updated automatically every couple of seconds using AJAX, so no "Enable Auto Refresh" needed.
* Displays the names of people who might be responsible for "breaking the build".
* Supports the [Claim plugin](https://plugins.jenkins.io/claim/), so that you can see who's fixing a broken build
* Supports [View Job Filters](https://plugins.jenkins.io/view-job-filters/), so that you can easily create Build Monitors for "slow builds", "only failing", etc.
* Supports [Build Failure Analyzer](https://plugins.jenkins.io/build-failure-analyzer/), so that you know not only *who*, but also *what* broke the build; [learn more](http://bit.ly/JBMBuild102)
* Supports [CloudBees Folders Plugin](https://plugins.jenkins.io/cloudbees-folder/), so that you can have project- and team-specific nested Build Monitors; [learn more](http://bit.ly/JBMBuild117)
* Supports [Pipeline Plugin](https://plugins.jenkins.io/workflow-aggregator/), so that the currently executing stage(s) are shown.
* The number of columns and size of the font used is easily customisable, making it trivial to accommodate screens of different sizes.
* UI configuration is stored in a cookie, making it possible to display different number of columns and using different font size on each of the screens at your office.
* Can work in a colour-blind-friendly mode; [learn more](https://github.com/jenkinsci/build-monitor-plugin/issues/30#issuecomment-35849019)
## Your feedback matters!
Found a bug or want to give feedback? Raise [an issue](https://github.com/jenkinsci/build-monitor-plugin/issues?state=open)
or submit a pull request ([start with this mini-dev guide](https://github.com/jenkinsci/build-monitor-plugin/wiki/Development-Guide), it might come in handy).
## Setting up
To create a new Build Monitor View, click on the "New View" tab, select "Build Monitor View" and select jobs you wish to display on the monitor.
Simple, right? :-) You can have as many Build Monitor Views as you want - the most popular approach is to have one per team or one per project.
# A picture is worth a thousand words
## (A)TDD
If you'd like to understand more about the logic behind the Build Monitor Plugin,
have a look at the [tests that drove the design](/build-monitor-plugin/src/test/java/com/smartcodeltd/jenkinsci/plugins).
## FAQ
### How do I let my teammates know that I'm fixing a broken build?
By claiming it. Build Monitor supports Jenkins [Claim Plugin](https://plugins.jenkins.io/claim/), so once you have it installed, enable "Broken build claiming" in the "Post-build actions" of your Jenkins job. From now on you'll be able to claim any further broken builds and Build Monitor will pick it up.
You might also be interested in a [script](https://wiki.jenkins.io/display/JENKINS/Allow+broken+build+claiming+on+every+jobs) that enables claiming on all your Jenkins jobs.
### How do I know what broke the build?
Wouldn't it be great to know _what_ made your build fail? Well of course it would. Build Monitor supports Jenkins [Build Failure Analyzer Plugin](https://plugins.jenkins.io/build-failure-analyzer/) so get it, teach it, and Build Monitor will tell you what the Failure Analyzer found out.
### I have too many jobs on one screen, what should I do?
You have several options here:
1. **review the granularity of your jobs**: If you have too many low-level jobs displayed on one screen, consider consolidating them using [Promoted Builds Plugin](https://plugins.jenkins.io/promoted-builds/) or [MultiJob Plugin](https://plugins.jenkins.io/jenkins-multijob-plugin/)
1. **use job filters**: Build Monitor supports Jenkins [View Job Filters Plugin](https://plugins.jenkins.io/view-job-filters/), if you have it installed
1. get a bigger screen ...
### Red and green colours are lovely, but I'm colour blind ...
There's a colour blind mode you can [enable in the Settings](https://github.com/jenkinsci/build-monitor-plugin/issues/30#issuecomment-35849019)
## Open Source Software Used
* [Angular.js](http://angularjs.org/)
* [Angular-slider](http://prajwalkman.github.io/angular-slider/)
* Customised [Angular Bootstrap](http://angular-ui.github.io/bootstrap/)
* [HTML5 Boilerplate](http://html5boilerplate.com/) normalize.css
* [OpenSans font](http://www.google.com/fonts/specimen/Open+Sans) by Steve Matteson
## Friends of Build Monitor
Build Monitor is continuously delivered to a Jenkins near you thanks to:
* the time and commitment of [the author](http://smartcodeltd.co.uk/) and [the contributors](https://github.com/jenkinsci/build-monitor-plugin/graphs/contributors)
* the [acceptance tests](/build-monitor-acceptance/src/test/java)