Firefox Add-on Build Monitor

Monitor Hudson builds and display the status on Firefox status bar. Use Hudson Build Monitor to keep track of Hudson builds. Add Hudson 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.

New homepage

latest wiki documentation can be found at here

Download & Installation

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

Starting Firefox 4, Hudson 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.

FAQ

  1. Q: How to add a feed to be monitored?
    A: Go to your Hudson web page. If you're on the dashboard or view page, the Hudson 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 Hudson 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.

Usage

  1. After restarting Firefox following an installation, a Hudson icon will appear on Firefox status bar panel.
  2. Go to your Hudson 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 Hudson 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 Hudson 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. Add new locale directory under /hudson/extras/firefox-extension/buildmonitor/src/chrome/locale directory.
  2. 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.
  3. Add the new locale to /hudson/extras/firefox-extension/buildmonitor/src/chrome.manifest
    locale    buildmonitor   <new_locale>    jar:chrome/buildmonitor.jar!/locale/<new_locale>/
    

Screenshots


 

 

 

Credits

Icons from Tango Desktop Project.

Sound effects from the freesound project:

Labels:

Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.
  1. Feb 10, 2009

    John Allen says:

    Is there any plans to support authenitcation?

    Is there any plans to support authenitcation?

    1. Mar 02, 2009

      Cliffano Subagio says:

      Sorry for the late reply, I hadn't been following the comments on this wiki page...

      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.

  2. Feb 10, 2009

    Jason Meridth says:

    For some reason, my configuration will not accept a straight domain like mydomai...

    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. Mar 02, 2009

      Cliffano Subagio says:

      Heya Jason, sorry I didn't notice this comment. As per your testing of the dail...

      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. May 28, 2009

    dominikg says:

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

    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. May 28, 2009

      David Saff says:

      Same issue.  Created a bug at https://hudson.dev.java.net/issues/show_bug.c...
      1. May 28, 2009

        Cliffano Subagio says:

        Thanks Dominik & David for reporting and raising the issue.  I'm plann...

        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. Jul 02, 2009

    henning juva says:

    Firefox 3.5 update please?

    Firefox 3.5 update please?

    1. Jul 02, 2009

      Cliffano Subagio says:

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

      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. Jul 02, 2009

        henning juva says:

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

        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. Jul 07, 2009

          henning juva says:

          Workaround: http://kb.mozillazine.org/Extensions.checkCompatibility Disable th...

          Workaround:

          http://kb.mozillazine.org/Extensions.checkCompatibility

          Disable the compatability check.

          1. Jul 07, 2009

            Cliffano Subagio says:

            Hudson Build Monitor1.0.1 should be compatible with Firefox 2.0 to ...

            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. Jul 21, 2009

          Cliffano Subagio says:

          I managed to reproduce this problem on a Vista box and found out that upgrading ...

          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. Jul 16, 2009

    James Lorenzen says:

    I am seeing an issue. Firefox 3, Ubuntu 8.10, Hudson 1.284.  I created a ...

    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. Jul 21, 2009

      Cliffano Subagio says:

      James, "for just latest builds" feed lists the build status in alphabetical ord...

      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. Jul 21, 2009

    James Lorenzen says:

    "Am I right to think that you expect to see red when there's a failed status on ...

    "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. Dec 27, 2010

      Peter Schuetze says:

      Actually, that would be my expectations too. I have 13 builds, 12 are blue and 1...

      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. Oct 11, 2010

    Patrick Wunderlich says:

    I recently updated from Hudson 1.352 to 1.379. After this update the Firefox add...

    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. Oct 18, 2010

      Cliffano Subagio says:

      Please upgrade to v1.6.1 to fix the problem you mentioned. https://addons.mozill...

      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. Dec 27, 2010

    Peter Schuetze says:

    If someone is still wondering on how to get the new tool bar to show up, have a ...

    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. Feb 02, 2011

    Cliffano Subagio says:

    I requested this wiki page to be restricted to hudson-commmitters only due to sp...

    I requested this wiki page to be restricted to hudson-commmitters only due to spam attacks in the past, but it looks like that I'm no longer in that group and I can no longer edit this page.
    Just to let everyone know that the latest wiki documentation can be found at http://wiki.jenkins-ci.org/display/JENKINS/Firefox+Add-on+Build+Monitor