TeamCity 2019.1 Help

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

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:

  1. Navigate to the Overview tab of the Build Configuration Home page (or the Overview tab of the Build Results page) and click Assign investigation.

    Assign an investigation of a failed build

  2. Select a TeamCity user from the Investigated by drop-down menu.

    Assigned an investigation of a failed build

  3. 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.

  4. 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.

Assign more investigations in the project

Assigning Investigations of Build Problems and Failed Tests

To assign an investigation of a particular build problem:

  1. 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.

    Investigate/mute a build problem

    The Investigate/Mute dialog opens.

  2. Select a TeamCity user from the Investigated by drop-down menu.

    Assigned an investigation of a failed build

  3. Select the condition to resolve the investigation:

    • Automatically when fixed
    • or, Manually

    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:

  1. 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.

  2. 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.

  3. Select the condition to unmute the problem:
    • Automatically when fixed
    • On a specific date
    • or, Manually

  4. Click Save.

Muting Failed Tests

You can mute a failed test or several tests at once on the Overview or Tests tab of the Build Results, similarly to muting build problems.

Investigate/mute a build problem

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 checkmark.png 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

Investigations and Muted Problems tabs

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:

New investigations

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.


See also:

Concepts: Build Configuration Status | Muting Test Failures
User's Guide: Viewing Tests and Configuration Problems