Build Monitor

Overview

The Build Monitor shows the build progress and output, using 4 different displays:

- The Progress display is a visual representation of the distributed build process.
- The Projects display shows, for each project/configuration built, the standard output from the executed tools including warning and error messages.
- The Output display shows the entire build's output text, similar to what would have been generated by Microsoft Visual C++ builds.
- The Summary display contains information and statistics on the current build.

In addition to the four displays, a "Did You Know" page contains useful tips for making the most out of IncrediBuild.

The Build Monitor display will automatically open when starting a build from the Visual Studio IDE or from the Agent menu. It can also be opened by selecting "Open Monitor" from the IncrediBuild menu in the Visual Studio IDE, by double-clicking the IncrediBuild tray-icon or by using the /OPENMONITOR command line console (BuildConsole.exe and xgConsole.exe). If opened while a build is running, the display will show the currently running build. The output for the last run build will be displayed if no build is currently running.

A progress bar located at the right hand side indicates the build's progress. The progress bar is colored according to the current build status (red, yellow or green). Double-click a yellow or red progress bar to jump to the first warning or error in the build output. You can also choose the way the progress bar calculation will handle files that were skipped during the build (count them as completed or disregard them altogether) through the small down-arrow icon located just above the progress bar.

The Different build displays can be selected by clicking on their appropriate icons in the left-hand portion of the Build Monitor:

The Progress Display

The progress display is the Build Monitor's main view, showing a visual representation of the distributed build process. Each file built is represented by a colored bar, colored according to the file's type and status: Blue for a file being built, green for a successfully built file, yellow for files that generated build warnings and finally red for files that failed to build. Bars representing custom build steps, link operations and creation of browse information will be colored cyan once these files have been successfully built.
Holding the mouse pointer above a colored bar will display the elapsed time for that point in the build, as well as any additional information available regarding that file. The display can also be panned to all directions (click and drag mouse) and zoomed in and out (CTRL/SHIFT+mouse click).

A context menu will be displayed when right-clicking a progress bar. This menu offers the following options:

A number of options useful for troubleshooting are also available in the right-click context menu:

The buttons in the upper-right hand side of the display can be used to zoom in/out, show or hide the system graphs and toggle the Agents bar/Time bar display.

Note that if double-clicking on a bar does not work well in a build run using either the Submission Interface or the Automatic Interception Interface, this can usually be resolved using the IdentifyTaskOutput keyword.

The Projects Display

The Projects display shows progress and build output for every configuration participating in the current build. The left side of the display shows a list of configurations along with their corresponding build progress bars. Clicking a configuration name will display that configuration's build output on the right-side part of the display, in a format similar to MSVC's output window. This display features the following enhancements over MSVC's standard output display:

- Multi-line messages can be expanded or collapsed to maintain a cleaner display. By default, only multi-line error messages are expanded, and all other messages are initially collapsed. This behavior can be modified via the Agent Settings dialog Build Monitor->General page.
- Warning and error messages are marked with a yellow or red icon respectively, to make locating these messages easier.

When using the Projects display and the Output display, the following features are available (also available from the display's right-click context menu and the toolbar):

The Output Display

Similar in format to the Projects display, the Output display shows the build output for the entire build, in the same manner Microsoft Visual C++ produces its output. This display may be convenient to users accustomed to MSVC's output display.

The Output display supports the same list of features available in the Projects Display.

Note that because IncrediBuild often builds more than one project at a time, some buffering of the build output is performed to ensure that output for different configurations will not mix. This behavior may result in files not being shown in the Output display despite having already been built. To view build output for all files use the Projects display.

The Summary Display

The Summary Display shows various statistics describing the build process and status, as well as currently utilized processing power and license information.

System Graphs

The Progress view can be used to monitor various system parameters during a build. To view system graphs, right-click the display and select "View system graphs". The graphs display will open showing currently selected graphs. hold the mouse cursor over a graph to see values for currently displayed graphs at the selected point in time.

To control which system parameters are displayed, right-click the display and select "Select system graphs...". A window allowing control of the system parameters and their corresponding graph color will show up.

Copyright (C) 2001-2011 Xoreax Software Ltd. All rights reserved.
Converted from CHM to HTML with chm2web Standard 2.85 (unicode)