Build Success Over Time Report
The Build Success Over Time report provides a pictorial version of the Build Summary report. The Build Success Over Time report displays the status of the last build for each build category run for each day. You can use this report to help track the quality of the code that the team is checking in. In addition, for any day on which a build ran, you can view the Build Summary for that day.
For information about how to access, refresh, or manage reports, see Reports (SQL Server Reporting Services).
Note
This report requires that the team project collection that contains your team project was provisioned with SQL Server Reporting Services. This report is not available if .png "Report"){kind=icon}
Reports does not appear when you open Team Explorer and expand your team project node.
In this topic
|
You can use this report to answer the following questions:
|
Required Permissions
To view the report, you must be assigned or belong to a group that has been assigned the Browser role in Reporting Services. For more information, see Add users to team projects.
Data That Appears in the Report
The data that appears in the Build Success Over Time report is derived from the data warehouse. The report summarizes build and test results for a set of build definitions in one or more projects over time.
The chart shows a separate row for each combination of build definition, platform, and configuration. The report shows only those combinations that fall within the filters that you have specified for the report. At a glance, you can determine the success or failure of builds for the time period under review, as the following illustration shows.
.png "Sample Build Success Over Time Report")
The daily results of runs of build definitions appear in the colors that the following table describes:
Build status |
Color |
Indicates |
|
|---|---|---|---|
Passed |
.png "Color green used in Build Success report") |
Green |
|
Tests Passed, Low Coverage |
.png "Color light green used in Build Success report") |
Light green |
|
Build Succeeded, No Tests |
.png "Color yellow used in Build Success report") |
Yellow |
|
Build Failed |
.png "Color red used in Build Success report") |
Red |
|
Tests Failed |
.png "Color orange used in Build Success report") |
Orange |
|
No build |
.png "Color white used in Build Success report") |
White |
|
You can filter the report in the following ways:
Change the start and end dates for the report.
Filter the build definitions by specifying the platforms, configurations, and build definitions to include in the report.
For more information, see Filtering the Report later in this topic.
Required Build Management Activities
For the Build Success Over Time report to be useful, team members must perform the following activities to manage builds:
Configure a build system. To use Team Foundation Build, you must set up a build system.
For more information, see Define your build process.
Create build definitions. You can create several build definitions, each of which can be run to produce code for a different platform. Also, you can run each build for a different configuration.
For more information, see Define your build process.
Run builds regularly. You can run builds can be run at set intervals or after every check-in. You can schedule regular builds when you use the schedule trigger. For more information, see Create or edit a build definition and Run, monitor, and manage builds.
Note
Although a team member can manually rate a build by using Build Explorer, this rating is not reflected in the Build Success Over Time report. The build rating appears in the Build Summary report. For more information, see Rate the quality of a completed build and Build Summary Report.
Setting the Duration of the Report
To understand the progress that your team is making in your current iteration, the start and end dates for the report must match those of your current iteration cycle.
To change the duration of the iteration
Next to Iteration Start (Date) or Iteration End (Date), click the calendar icon, and then click a date.
Click View Report.
Interpreting the Report
You should expect the Build Success Over Time report to vary based on where you are in your product development cycle. Early iterations often exhibit some builds and tests failing. By reviewing the report together with the team early and often, you might be better able to focus efforts toward creating stable builds with high rates of tests passing.
Questions That the Report Answers
You can review the Build Success Over Time report to find answers to these questions:
How high is the quality of the builds?
Is the quality improving, deteriorating, or staying constant?
What parts of the project are ready to test?
What parts of the project are having trouble with regressions or bad checkins?
How well is the code tested?
Team members should review the last column of the Build Success Over Time report to determine whether the most recent builds have passed. If long sections in the report are not green, project managers and development leads should determine the root of persistent problems.
Healthy and Unhealthy Versions of Report
A healthy Build Success Over Time report will show successive days of green, which indicate that builds are passing. An unhealthy version of the report will show long blocks of orange or red. These blocks indicate that builds are not passing or that tests are failing. The following illustration shows that some builds are in good shape and some need investigation:
.png "Healthy and Unhealthy version of Build Success")
Filtering the Report
You can filter the Build Success Over Time report in the following ways:
Change the start and end dates for the report.
Filter the builds that appear in the report by specifying the platform, configuration, and build definitions to include.
Note
You can configure build definition to run no tests, some tests, or all tests. The report will vary greatly based on the configuration of the build definitions.
The following illustration shows the available filters:
.png "Filters for Build Summary report")
You must apply the filters in the sequence that the following procedure specifies. The options that are available with some filters depend on the filters that you applied previously.
To filter the builds that appear in the report
In the Platform list, select the check box of each platform to include.
In the Configuration list, select the check box of each configuration to include.
In the Build Definition list, select the check box of each build definition to include.
Click View Report.