Subscribing to Notifications

Builds from the selected project

Select a project whose builds you want to monitor. Notification rules defined for a project will be propagated to its subprojects. To monitor all of the builds of all the projects' build configurations, select Root project.

Builds from the selected build configurations

Check to monitor all of the builds of the selected build configurations. Hold the Ctrl key to select several build configurations.

System wide events

Select to be notified about system wide events.

• Ignore failures not caused by my changes

This option can only be enabled when the Watch builds affected by my changes option is used. Check this option not to be notified when a build fails without any new problems after a build with your changes.

• Only notify on the first failed build after successful

Check this option to be notified about only the first failed build after a successful build or the first build with your changes. When using this option, you will not be notified about subsequent failed builds.

Build is successful

Check this option to receive notifications when a build of the specified build configurations executed successfully.

• Only notify on the first successful build after failed

Check this option to receive notifications when only the first successful build occurs after a failed build. Notifications about subsequent successful builds will not be sent.

The first error occurs

Check this option to receive notifications about a "failing" build as soon as the first build error is detected, even before the build has finished.

Build starts

Check this option to receive notifications as soon as a build of the specified build configurations starts.

Build fails to start

Check this option to receive notifications when a build of the specified build configurations Build State.

Build is probably hanging

Check this option to receive notifications when TeamCity identifies a build of the specified build configurations as Configuring General Settings.

Investigation is updated

Check this option to receive notifications on changing a build configuration or test investigation status, t.g. someone is investigating the problem, or problems were fixed, or the investigator changed.

Tests are muted or unmuted

Check this option to receive notifications on the test Muting Test Failures status change in the affected build configurations.

An investigation is assigned to me

This option is available only if the _ System wide events _option is selected in the Watch area. Check the option to be notified each time you start investigating a problem.

Select Build Configurations

List build configurations

Specify which build configurations to display in the Select build configurations or projects field. The following options are available:

• With the external status enabled: if this option is selected, the next field shows the list of build configurations with the Configuring General Settings, and build configurations visible for everybody without authentication.

• Available to the Guest user: Select this option to show the list of build configurations, which are visible to a user with the Guest permissions.

• All: Select this option to show a complete list of build configurations. The option requires HTTP authorization. Selecting this option enables the Feed authentication settings field. If the external status for the build configuration is not enabled, the feed will be available only for authorized users.

Select build configurations or projects

Use this list to select the build configurations or projects you want to be informed about via a syndication feed.

Feed Entries Selection

Generate feed items for

Specify the events to trigger syndication feed generation. You can opt to select builds, changes or both.

Include builds

Specify the types of builds to be informed about:

• All builds

• Only successful

• Only failed

Only builds with changes of the user

Select the user whose changes you want to be notified about. You can get a syndication feed about the changes of all users, yours only, or of a particular user from the list of users registered to the server.

Other Settings

The following options are available only if All is selected in the List build configurations section.

Include credentials for HTTP authentication

Check this option to specify the user name and password for automatic authentication. If this option is not checked, you will have to enter your user name and password in the authorization dialog box of your feed reader.

TeamCity User, Password

Type the user name and password which will be used for HTTP authorization. These fields are only available when the Include credentials... option is checked.

Copy and paste URL to your feed reader or Subscribe

This field displays a URL generated by TeamCity on the basis of the values specified above. You can either copy and paste it to your feed reader or click the Subscribe link.

itemsCount

a number; limits the number of items to return in a feed. Defaults to 100.

sinceDate

a negative number; specifies the number of minutes. Only builds finished within the specified number of minutes from the moment of feed request will be returned. Defaults to 5 days.

template

name of the custom template to use to render the feed (<template_name>). The file <TeamCity Data Directory>\config\<template_name>.ftl should be present on the server. See the Customizing Notifications on the file syntax.