TeamCity 2019.2 Help

Build Agents Configuration and Maintenance

Viewing TeamCity agents details

The Agents page of the TeamCity web UI provides the comprehensive information on the TeamCity agents. The number of tabs on the page may differ depending on your agent setup.

Connected / Disconnected

The Connected and Disconnected tabs display the agents by Agent pool (default). To view the agents alphabetically, uncheck the Group by agent pool box.
For each pool TeamCity displays the status of its build agents. Clicking the arrow next to the pool displays the list of the pools agents with their statuses.

Enabling/Disabling Agents via UI

TeamCity distributes builds only among the enabled agents. Agents can be manually enabled/disabled via the web UI by clicking the status icon (1) next to the agent's name. Optionally, you can tell TeamCity to automatically disable/enable the agent after a period of time and enter your comment. TeamCity will follow the instructions and show the comment icon (2). Hovering over the icons will display the related information (3).

Enable/disable an agent


Refer to a separate page for information on configuring agent pools in TeamCity.

Parameters report

Filter all available agents using a specified parameter.

Matrix and Statistics

Refer to a separate page for information on viewing the agents workload.


Lists all configured agent cloud profiles.


Compare two agents and see their differences highlighted.