Due to some maintenance issues, this service has been switched in read-only mode, you can find more information about the why

and how to migrate your plugin documentation in this blogpost

Skip to end of metadata
Go to start of metadata

Plugin Information

No information for the plugin 'firefoxaddon' is available. It may have been removed from distribution.

This plugin is up for adoption. This add-on is looking for a co maintainer. Contact cliffano@gmail.com Click here to learn more!

Monitor Jenkins builds and display the status on Firefox status bar. Use Jenkins Build Monitor to keep track of Jenkins builds. Add Jenkins feed URL to Build Monitor and an icon representing the builds status will appear on Firefox status bar.

Either mouse over the status icon to view the tooltip and quickly check the builds information, or left click the icon and select a build page to open. It's also easy to trigger a build by using one of the menu options.

Download & Installation

Visit https://addons.mozilla.org/en-US/firefox/addon/7522 and click 'Add to Firefox' button.

Starting Firefox 4, Jenkins icon is displayed on add-on bar. An add-on bar is disabled by default (at least as of Firefox 4 Beta 7), you have to manually enable it.
On OS X: View -> Toolbars -> Add-on Bar.
Windows & Linux users? Please leave a comment with the instruction on how you enabled the Add-on Bar, I'll add it to this section.

OS X users are required to configure Firefox:

  • type about:config on Firefox URL bar, press enter
  • search for browser.preferences.instantApply , the default value on OS X is true, set this to false

This change is needed due to a problem with preference accept button behaviour with FF3.* on OS X, more info is available from http://forums-test.mozillazine.org/viewtopic.php?f=19&t=698285 .
By setting instantApply to false, you'll have to click OK button when you change FF Add-on Preferences.

OS X users are also required to install Growl to provide alerts service on Firefox.

FAQ

  1. Q: How to add a feed to be monitored?
    A: Go to your Jenkins web page. If you're on the dashboard or view page, the Jenkins feed links are located at the bottom right area. If you're on a job page, the feed links are at the left area bellow the build history. Right clink on a feed link (for all, for failures, or for just last builds), select Add Link To Jenkins Build Monitor. Provide a name and click OK.
  2. Q: How to monitor a group of jobs?
    A: You can either add the feeds of those jobs one by one, or you can create a view that contains only the jobs that you want and then add the feed link of that view.
  3. Q: How to display only the latest build status?
    A: Go to Preference -> Display -> select latest build from the drop down list.
  4. Q: I'm using OS X and Growl, I'm getting error message "Unable to add link" when I try to add a Jenkins feed link, and on the error console I see error "Component returned failure code: 0x80570016 (NS_ERROR_XPC_GS_RETURNED_FAILURE)".
    A: The first thing you should try is to uninstall then reinstall Growl. If that doesn't work, try a new Firefox.dmg installation, or try a fresh Firefox profile. Check out the comments section on https://issues.jenkins-ci.org/browse/JENKINS-8899

Usage

  1. After restarting Firefox following an installation, a Jenkins icon will appear on Firefox status bar panel.
  2. Go to your Jenkins web site, right click on a feed link (i.e. "for all", "for failures", or "for just last builds" links) and select "Add Link To Jenkins Build Monitor" from the menu.
  3. Provide a name for the feed, then click OK. Build Monitor will suggest a name for the feed depending on whether the feed is for the whole Jenkins instance, or specific to a particular job.
  4. The feed status icon will appear on Firefox status bar. Mouse over it to see the build details on a tooltip. If you want to visit any of those builds' web page, left click the weather/orb icon, and a build menu will appear. Click on any of the build items to open the corresponding build web page.
  5. Preferences window can be opened via right click menu of a status icon.

Check out the demo video of Build Monitor 0.9.

Translation

Build Monitor has been translated to French, Indonesian, and Japanese. If you're interested in helping with the translations, please submit a patch to the issue tracker. If you have commit rights, please feel free to add the translation yourself.

To add a new locale, please follow these steps:

  1. Fork https://github.com/jenkinsci/firefox-extension-buildmonitor .
  2. Add new locale directory under /src/main/resources/firefox/chrome/locale directory.
  3. Add buildmonitor.dtd and buildmonitor.properties files in that directory. Have a look at en-US locale directory as example, copy paste the content to the new locale files, translate the value of each property.
  4. Add the new locale to /src/main/resources/firefox/chrome.manifest
    locale    buildmonitor   <new_locale>    jar:chrome/buildmonitor.jar!/locale/<new_locale>/
    
  5. Submit a pull request.

Screenshots


 

 

 

Credits

Icons from Tango Desktop Project.

Sound effects from the freesound project:

30 Comments

  1. Unknown User (skaze)

    Is there any plans to support authenitcation?

    1. Unknown User (cliffano)

      Sorry for the late reply, I hadn't been following the comments on this wiki page. I just added it to my watch list.

      Basic authentication support was just implemented, it will be included in release v0.1 (probably 1 or 2 weeks away).

      If you'd like to give it a test, I can send you the nightly build version.

      Please let me know if you require a different authentication support.

      1. Unknown User (zzzeek)

        only supports one username/password for all servers ?

        1. Unknown User (cliffano)

          Feed-level authentication support was just added in v1.6.3, soon available on mozilla.org .

          You need to change the URL to http://username:password@host:port/path , this will override the global network username password config.

  2. Unknown User (jmeridth)

    For some reason, my configuration will not accept a straight domain like mydomain.com that does a proxy redirect internally to port 8080.  Is this correct?

    1. Unknown User (cliffano)

      Heya Jason, sorry I didn't notice this comment.

      As per your testing of the daily build that I sent you, it looks like basic authentication feature solved your problem. Let me know if it's something else.

  3. Unknown User (dominikg)

    using build monitor 1.0.1 i got an error connecting to a feed from hudson 1.306:

    BuildMonitor [Donnerstag, 28. Mai 2009 11:56:50][main]: An unexpected error has occured while parsing response text. Exception: TypeError: container.getElementsByTagName(name)[0].childNodes[0] is undefined

      (firefox error console)

    But it seems to work fine... any chance to get rid of that message?

    1. Unknown User (david@saff.net)

      1. Unknown User (cliffano)

        Thanks Dominik & David for reporting and raising the issue.

         I'm planning to rewrite the extension now that I understand both FF add-on and Hudson better, will definitely pay attention to this issue.

  4. Unknown User (hjuva)

    Firefox 3.5 update please?

    1. Unknown User (cliffano)

      I could use v1.0.1 with FF3.5 just fine, both on an upgrade and a fresh install.

      Could you provide more details on the problem that you're having? versions, OS, etc. Thank you.

      1. Unknown User (hjuva)

        That's strange. Tried it at home on a fully updated Windows XP system with FF3.5 and it installed ok.

        At my work it doesn't. I have 2 machines there, Vista 64 and XP SP3. Both try to install the plugin OK and then pops a message box saying "Hudson Build Monitor 1.0.1 could not be installed because it is not compatible with Firefox 3.5."

        I tried updating with the latest version of both FF English UK and US today but no difference. Also did a complete uninstall removing all plugins history etc before reinstalling. Still the same.

        The Vista box is not connected to the internet so I have to manually copy across the FF installer and the addon-7522-latest.xpi file but that shouldn't really affect things.

        1. Unknown User (hjuva)

          1. Unknown User (cliffano)

            Hudson Build Monitor1.0.1 should be compatible with Firefox 2.0 to 3.6a1pre . So it's really weird that it doesn't work on certain machines.

            Thanks for the mozillazine.org link with the info to disable the compatibility, it would be handy for others experiencing the same problem.

        2. Unknown User (cliffano)

          I managed to reproduce this problem on a Vista box and found out that upgrading the maxVersion in install.rdf fixes the problem.

          I have uploaded version 1.0.2, it's available for download at https://addons.mozilla.org/en-US/firefox/addons/versions/7522#version-1.0.2

          This version is currently waiting for a reviewer's approval. In the mean time, you have to login to addons.mozilla.org to install 1.0.2, sorry.

  5. Unknown User (jlorenzen)

    I am seeing an issue.

    Firefox 3, Ubuntu 8.10, Hudson 1.284.

     I created a new view in hudson to point to 3 jobs. Currently one of those jobs is Blue; the other 2 are Red. I used the "for the latest builds" RSS Feed as well.

    The overal status in firefox is showing Blue. When I hover over the firefox plugin, it shows 1 BLUE, 2 RED.

    1. Unknown User (cliffano)

      James,

      "for just latest builds" feed lists the build status in alphabetical order, so the blue status you see comes from the first blue build on the list.

      The add-on currently (as of 1.0.20 has 2 options to determine the status:

      1. Overall health - displays the weather icon as a summary of all builds within the list.

      2. Latest build - displays the orb color based on the status of the first build. This is ok for "for all" and "for failure" feeds, but not "for just latest builds" in your case. I'll fix this in version 1.5.* , it shouldn't assume that the feed is already sorted in descending order.

      Am I right to think that you expect to see red when there's a failed status on the list, regardless whether it's the last one or not?

  6. Unknown User (jlorenzen)

    "Am I right to think that you expect to see red when there's a failed status on the list, regardless whether it's the last one or not?"

    Yes that is correct. Those would be my expectations.

    1. Unknown User (peter_schuetze)

      Actually, that would be my expectations too. I have 13 builds, 12 are blue and 1 is red. Since we regularly need to consume release updates for a major external reference, it is important for me to see the worst status and not an overall status. Currently, I see yellow and not as expected red.

      For me the yellow status is in many cases fine and I don't need to act on it. (It's other peoples responsibility.) However, a red status might ask for my attention (even if it is just an escalation of the issue).

      I am using version 1.6.1

  7. Unknown User (xkill)

    I recently updated from Hudson 1.352 to 1.379. After this update the Firefox addon doesn't display icons for the latest build (preferences - display - latest build) any more. Reinstalling the addon doesn't solve this issue.

    1. Unknown User (cliffano)

      Please upgrade to v1.6.1 to fix the problem you mentioned. https://addons.mozilla.org/en-US/firefox/addon/7522/versions/?page=1#version-1.6.1

      This version is still waiting for a Mozilla reviewer's approval, hence you have to upgrade manually. I was hoping that the approval would've happened sooner :) so the fix would've been rolled out to users without anyone noticing, but of course that didn't happen.

      FYI, the error was caused by a change in build information in Hudson atom feed. It used to pass build status, it now passes build status summary, e.g. what used to be 'FAILED' is now 'has been failing for the past N builds'.

  8. Unknown User (peter_schuetze)

    If someone is still wondering on how to get the new tool bar to show up, have a look at the following page:

    http://support.mozilla.com/en-US/kb/what-happened-status-bar#w_where-are-my-add-ons

     

    At the top of the Firefox window, click on the Firefox button, go over to the Options... arrow and check Add-on Bar.

  9. Unknown User (kathyvs)

    I just added Jenkins plugin, and when I right click the feed link, the "Add link to Jenkins" part comes up, but when I click on that I get the error "Unable to add link to Jenkins. Please remove an existing feed".  Since I have no feeds this error is not helpful.

    1. Unknown User (peter_schuetze)

      Hi Kathy,

      can you create an issue for that (http://issues.jenkins-ci.org). It is easier to communicate that way and for you to add additional information (e.g. Browser version). BTW, I could install it without any problems. I have Firefox 3.6.13 but I installed the previous version and upgraded when the new version was released.

    2. Unknown User (cliffano)

      I just retested installing Build Monitor 1.6.2 on Firefox 3.6.13 and 4.0b11 on OS X, both worked fine.

      What browser version + OS did you use? Any error message on Tools -> Error Console? Please also try uninstalling/disabling other add-ons installed on your FF, then install Build Monitor and see if you still have the problem.

      1. Unknown User (kathyvs)

        The preferences problem was caused by me no reading the OSX information at the top of the page.  Changing the setting fixed the problem.

        I am still getting an error when trying to add a feed. I've created an issue with the details.

  10. Unknown User (abraxas)

    Nice plugin, unfortunately it does not work for me as I expect... I am using plugin version 1.6.3 on FF 6.0.1 on Windows 7 64Bit and Jenkins 1.428

    1. I do not see any icons for the latest build.

    2. Even for overall health it always shows the cloud with lightning for me. Even when I monitor single jobs that have never failed. That makes the view pretty useless for me, tbh.

    Any ideas?

    1. Unknown User (bkimminich)

      I have the exact same problem in my FF 12.0 on Windows XP here for a Jenkins 1.477. Thanks in advance to the author for looking into this problem! (thumbs up)

  11. Unknown User (sinj)

    RE: Windows & Linux users? Please leave a comment with the instruction on how you enabled the Add-on Bar, I'll add it to this section.

    Install addon bar extension to use this jenkins extension. https://addons.mozilla.org/en-US/firefox/addon/the-addon-bar/

    1. Unknown User (peterwippermann)

      Yeah, I think this addon behaves a little "buggy". At least it doesn't easily comply with the latest changes to FF's handling of Addon icons.

      Normally the Build Monitor Icon should be available on the customisation page: https://support.mozilla.org/en-US/kb/what-happened-to-the-add-on-bar

      For me it wasn't. So I installed the "The addon bar (restored)" plugin and dragged the icon from there to my menu bar.