Walkthrough: Viewing Team Build Report Results

This walkthrough shows you how to use Team Foundation Build to analyze the results of a build.

In this walkthrough, you step through the process of analyzing and understanding the results of a project build. You will complete the following tasks:

• Investigate the summary status information in the Build Explorer.

• View the Detailed Build report.

• View the log file.

• View the built binaries.

Prerequisites

• Visual Studio Team System.

• Completion of Walkthrough: Creating a Build Definition in Team Foundation Build and Walkthrough: Running a Build Definition in Team Foundation Build.

Required Permissions

To complete this walkthrough, you must have the View project-level information permission set to Allow. For more information, see Team Foundation Server Permissions.

To investigate the summary status information in Build Explorer

1. Open Team Explorer, and in the applicable team project, expand the Builds node.

2. Right-click either the Builds node, or any build definition listed under it, and then click View Builds on the drop-down menu.

   The Build Explorer appears. In the Build Explorer, you can view summary status information on builds that have run or are currently running.

3. To view the in-progress builds, click the Queued tab.

   The queued pane of the Build Explorer appears.

   The toolbar includes the following filters to filter the in-progress builds:

   • Build Definition

     Select a build definition name from the drop-down list to filter the in-progress builds on a build definition. You will see a list of all the build definitions that belong to the team project.

   • Status Filter

     Select a status from the drop-down list to filter the in-progress builds on status. You can select from Any Status, Queued, In Progress or Postponed.

   • Agent Filter

     Select a build agent from the drop-down list to filter the in-progress builds on build agent. You can select a specific build agent or Any Build Agent. For more information about build agents, see How to: Create and Manage Build Agents.

   The information is categorized in columns and includes Build Definition, Priority, Date Queued, Requested By, and Build Agent,

4. To view the completed builds, click the Completed tab.

   The Completed pane of the Build Explorer appears.

   The toolbar includes the following filters to filter the completed builds:

   • Build Definition

     Select a build definition name from the drop-down list to filter the completed builds on a build definition. You will see a list of all the build definitions that belong to the team project.

   • Quality Filter

     Select a build quality from the drop-down list to filter the completed builds on build quality. You can select from any previously added build quality values. You can show all build quality values by selecting <Any Build Quality>.

   • Date Filter

     Select a date filter from the drop-down list to filter the completed builds by the date on which they completed.

   The information in categorized in columns and includes Name, Build Definition, Build Quality, Date Completed, and Requested By.

   Note

   To sort the columns alpha-numerically, you need to click the column headers.

5. To modify the Build Quality, right-click a build row, and choose Edit Build Quality.

   A drop-down list will appear in the Build Quality column next to the build quality value for the build that you selected. The available quality values are Initial Test Passed, Lab Test Passed, Ready for Deployment, Ready for Initial Test, Rejected, Released, UAT Passed, and Under Investigation. You can also define your own build qualities. For more information, see How to: Create or Remove Build Qualities..

   The selected build quality is updated in Build Explorer.

To view the Detailed Build report

• In the Build Explorer, in the Completed pane, double-click the Name, or click in the Queued pane, and then double-click the Build Definition column under any build to open it in its own window for reviewing the details associated with it.

  The detailed build report displays the following sections. For more information, see Overview of Build Reports.

  • Summary   View the overall status of the build.

  • **Build steps   **Displays the build steps conducted during the build.

  • Result details for <build configuration/platform>   Displays the detailed results.

  • **Associated changesets   **Lists the changesets affiliated with the build.

  • **Associated work items   **View the work items associated with the build.

To view the log file

1. Open the Detailed Build report as described in the previous procedure.

2. In the Summary section, in the Log row, click the active link in the Log row.

   The detailed log file is saved in the following location on the build agent:

   {Build drop location}\{Build Number}\buildlog.txt

To view the build binaries

1. Open the Detailed Build report.

2. Click the active link next to the build name.

   The binaries are saved in the following location on the build agent:

   {Build drop location}\{Build Number}\Release

See Also

Tasks

Walkthrough: Running a Build Definition in Team Foundation Build

Other Resources

Working with Build Definitions in Team Foundation Build