This page last changed on Mar 09, 2009 by alui.

The Hanging Build event is thrown when a Bamboo determines that a build has become unresponsive according to two criteria:

  • 'Expected Build Time' — the 'Expected Build Time' = 'Build Time Multiplier' times the 'Average Build Time'
    • the 'Build Time Multiplier' is a user-defined setting.
    • the 'Average Build Time' is calculated by Bamboo using an average of previous build times (in minutes).
  • 'Log Quiet Time' — the length of time (in minutes) between log entries for a build.

The 'Expected Build Time' and 'Log Quiet Time' must both be exceeded for Bamboo to throw the build hung event.

On this page:

Where is this event used?

This event can currently be used to trigger notifications. Read more about Adding or Removing Notifications for a Plan.

How do I configure the Hanging Build event?

You can change the criteria governing when the Hanging Build event is thrown, or disable it altogether so that it never occurs.

Please note that the Hanging Build criteria can be also be set for a specific plan, when specifying a plan's builder. Plan-level criteria will override the global criteria described on this page (including disabling the event).

To disable the Hanging Build event,

  1. Click the 'Administration' link in the top navigation bar.
  2. Click the 'Hanging Build Detection' link in the left navigation column.
  3. The 'Default Hanging Build Detection' screen will be displayed (see screenshot below). Click the 'Disable' button to disable this event.
     
    Screenshot: 'Default Hanging Build Detection'

To edit the Hanging Build event settings,

  1. Click the 'Administration' link in the top navigation bar.
  2. Click the 'Hanging Build Detection' link in the left navigation column.
  3. The 'Default Hanging Build Detection' screen will be displayed. Click the 'Edit' button.
  4. The two Hanging Build Criteria will now be editable, 'Build Time Multiplier' and 'Log Quiet Time' (see screenshot below). Update the values for these two fields as desired.
  5. Click the 'Save' button to update your settings.
     
    Screenshot: 'Default Hanging Build Detection - Edit Criteria'

How do I change how often Bamboo checks for hung builds?

By default, Bamboo will check whether a Hanging Build event has been thrown every 60 seconds. You can change this by configuring the system property, bamboo.buildHangingMonitor.checkInterval. This property is specified in seconds.

Please read the Configuring System Properties page for instructions on how to configure the bamboo.buildHangingMonitor.checkInterval system property.


Document generated by Confluence on Mar 09, 2009 17:06