TeamCity 2019.1 Help

Investigating and Muting Build Problems

When for some reason a build fails, TeamCity provides handy means of figuring out which changes might have caused the build failure.

You can assign some of your team members to investigate what caused the failure of this build or to start the investigation yourself. When an investigator is set, he/she receives the corresponding notification.

TeamCity also provides a way to mute a build problem (similarly to muting failed tests) so that it not affect build status for future builds.

On this page:

Investigating or Muting Build Problems

To assign an investigation of a failed build:

  1. Navigate to the Overview tab of the Build Configuration Home page, or the Overview tab of the Build Results page, click the Start investigation... link.

  2. Select a team member's name from the User drop-down menu.

  3. Select the condition to remove the investigation: when the build configuration becomes green or the test passes (default) or specify that an investigation should be resolved manually.
    Manual resolution is useful with so called "flickering tests", i.e. when a test fails from time to time and the "green" status of a build is not an indicator of the problem resolution.

  4. Save your investigation.

To investigate a problem in more than one build configuration, click more and select the desired build configurations.

To assign an investigation / mute a particular build problem:

  1. Navigate to the Overview tab of the Build Results page, click the arrow next to the build problem, click the Investigate link.

  2. The Investigate / Mute Build problem dialog opens. Select the investigation or muting options and save them:

Investigate/mute a build problem

To assign an investigation / mute a particular test, navigate to the Tests tab, Current Problems tab or Problematic Tests of the Build Results page, click the arrow next to the test name and select Investigate.

Viewing Investigations and Mutes

A subject for investigating/ muting is not necessarily the whole build, it can also be a build problem, a particular test. For each project you can find out what problems are currently being investigated and by whom using the dedicated Investigations page. All mutes are listed on the Muted Problems tab:

Investigations and Muted Problems tabs

My Investigations

To view all problems assigned to you to investigate, click the box with a number next to your name on the TeamCity top panel:

New investigations

On the My Investigations page you can see the investigations assigned to you in different projects and monitor the problems in the build log. 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 monitor a lot of information instantly, without leaving this page. For example:

  • 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