Version 16 (modified by sa2ajj, 6 years ago) (diff)



The buildmaster and buildslaves run as a background daemon process, and thus have no output to show off. However, many of the status delivery plugins are a bit more photogenic.


The Console view gives an overview of all builds oriented toward the developer's needs: what failed, and which changes might have caused it? In this build, three builders have failed, one for a long time, and two starting just two revisions ago.


The Grid view provides a different look at the build history, comparing revisions and builders on a grid. This view is useful for spotting patterns in build failures. A transposed grid view is also available that reverses the axes of this display.


The Waterfall display is a web page that shows a chronological log of events. Each Builder gets a separate column, and usually there is a Builder for each distinct platform (or major version of some component library). The most recent events appear at the top of the page, and older events appear below them.

Each Build is a set of events, starting with the yellow "start build" box, followed (above the starting box) by a checkout step of some sort, then other compile/test steps as necessary. The config file controls which steps are run for which builds.

Each step contains hyperlinks to generated logfiles. On the left hand side is a "Changes" column which contains links to pages that describe the version-control patches or revisions that triggered the build.

IRC bot

The IRC status plugin can be configured to join a specific server and channel. Once it has connected, other users can direct queries to the buildbot to learn about current operations and retrieve the results of recent builds. If enabled, the IRC bot can be used to force a build to be started.

Some users have enhanced their buildbot to detect when a build has failed and actively insult the developer responsible. The developer who fixes the build gets to choose the insult used the next time.

Live Status Clients

The 'buildbot statusgui' command runs a rough graphical client which connects to the "status port" and presents a real-time display of what each Builder is doing. Any build steps that are currently running are shown, along with their ETA. The results of the most recent build are also displayed.

In this example, a library is being tested against various versions of Python. The "python2.4" build has just started. The current step is a Darcs checkout, which is expected to complete at 1:26am (in four seconds from now). The build as a whole is expected to complete at 1:27am (in 34 seconds from now). These ETA displays are continually updated as the various checkout/compile/test steps progress. The most recent builds of "python2.4" and "python2.5" were successful, however the most recent build of the "2.4-nocrypto" builder was massively unsuccessful, with 171 failing test cases.

Debug Tools

The 'buildbot debugclient' command launches a simple Gtk-based debug control panel, mostly of use to developers but also handy for buildbot admins. From here you can force a build to be triggered.

Attachments (7)

Download all attachments as: .zip