Investigating and Muting Build Failures
When a build fails due to some problem or a failed test, TeamCity allows you to assign an investigation of the build failure to some user or to mute the failure so it does not affect the build status.
You can assign an investigation of the whole failed build configuration, or investigate/mute single build problems and failed tests. The Investigate/Mute functionality works identically for build problems and failed tests.
On this page:
- Required Permissions
- Assigning Investigations of Failed Build Configurations
- Assigning Investigations of Build Problems and Failed Tests
- Muting Build Problems
- Muting Failed Tests
- Marking Problems as Fixed
- Viewing Investigations and Mutes
- Viewing My Investigations
To be able to manage and view investigations/mutes in a certain project, the user must have the following permissions granted in this project:
"Mute/unmute problems in project" for managing mutes
"Assign/unassign investigation" for managing investigations
"View project and all parent projects" for viewing investigations/mutes
These permissions are granted to Project Administrators and System Administrators by default.
Assigning Investigations of Failed Build Configurations
To assign an investigation of a failed build configuration:
Select a TeamCity user from the Investigated by drop-down menu.
Select the condition to resolve the investigation:
- When build configuration is successful
or, Manually; this mode is recommended for build configurations with flaky tests, when the "Success" build status does not directly indicate that the problem has been resolved.
The user to whom the investigation is assigned can later mark the problem as fixed in this window.
Save the investigation.
To assign similar investigations for other failed build configurations in the same project, click more and select the configurations in the list.
Assigning Investigations of Build Problems and Failed Tests
To assign an investigation of a particular build problem:
The Investigate/Mute dialog opens.2. Select a TeamCity user from the Investigated by drop-down menu. 3. Select the condition to resolve the investigation:
- Automatically when fixed
The user to whom the investigation is assigned can later mark the problem as fixed in this window.4. Save the investigation.
You can similarly assign an investigation of a failed test on the Overview or Tests tab of the Build Results.
Muting Build Problems
To mute a particular build problem:
Navigate to the Overview tab of the Build Results page (or the Current Problems tab of the Project Home), click the arrow next to the build problem, and then click Investigate/Mute.
The Investigate/Mute dialog opens.
Choose where to mute the problem:
Project-wide, that is muting the problem in all configurations in the current project and its subprojects.
Selected build configurations, which allows you to select particular build configurations from the same project.
Select the condition to unmute the problem:
- Automatically when fixed
- On a specific date
Muting Failed Tests
Muting will only affect builds which fail on the "At least one test failed" build failure condition but not on the other conditions: if any other failure condition applies to your build (for example, non-zero exit code), the build will still fail even if the failing tests are muted.
This feature is useful when some tests fail for a known reason, but it is not currently possible to fix them. For example, the responsible developer is absent, or you are waiting for the system administrator to fix the environment. The feature could also be used if the test is failing intentionally: for example, if the required functionality is not yet ready.
In all these cases you can mute such failures and avoid unnecessary disturbance of other developers.
When a test is muted, it is still run in the future builds, but its failure does not affect the build status.
Your build script might need adjustment to make the build successful when there are failing but muted tests. Make sure the build does not fail because of other build failure conditions (for example, "Fail if build process exit code is not zero") in case the only errors encountered were tests failures. See the related issue TW-16784 for more details.
Marking Problems as Fixed
A user, to whom the investigation is assigned, can mark the investigated problem as fixed in any Investigate UI dialog corresponding to this problem.
The problem will be marked with on all TeamCity pages it appears. This allows identifying a potentially fixed problem in the UI, but leaves a possibility to continue the investigation if the problem persists in the following build run. If the author of the investigation has the respective notifications turned on, they will be notified about the fix.
TeamCity will remove the investigation in the following build run after the investigation is marked as fixed, if the problem is not reproduced and if this investigation has the "Automatically when fixed" resolution condition.
Viewing Investigations and Mutes
You can find all the investigations and mutes per project on the Project Home page:
Investigations tab: see all assigned investigations in the project
Muted Problems tab: see all muted problems and tests in the project
Here you can unmute problems and tests, and reassign the investigations to another user or mark them as fixed.
Viewing My Investigations
If one or more investigations are assigned to you, the investigation counter will appear next to your name on the TeamCity top panel:
Click it to open the My Investigations page where you can see all the investigations assigned to you in different projects. You can manage the problems directly on this page: mark them as fixed, reassign, mute, or give up the investigations.
For each failed test, you can instantly see:
all build configurations where the test is currently failing
current stack trace and the information about the build where the test is currently failing
information about the first failure of the test, with the stack trace and the build
The investigations assigned to you are also highlighted in the Web UI if you enable the "Highlight my changes and investigations" option in your profile settings.