This documentation relates to an earlier version of Bamboo.
View

Unknown macro: {spacejump}

or visit the current documentation home.

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. You can also disable build monitoring altogether so that the Hanging Build event never occurs.

(info) 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 edit the Hanging Build event settings,

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

How do I disable the Hanging Build event?

You can disable the Hanging Build event by disabling build monitoring for your Bamboo installation. See Disabling Build Monitoring.
(info) Please note, you cannot disable the Hanging Build event without disabling all build monitoring features for your Bamboo installation.

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.



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.