Agents

Added by Irina Megorskaya, last edited by Christopher Hamilton on Feb 06, 2008  (view change)
Documentation Index

Agents

In this section:

Connected Agents
Disconnected Agents
Unauthorized Agents
Agent Statistics (version 3.1 only)

Item Description
Install build agent
Click this button to install an additional build agent, using one of the suggested techniques. Refer to Installing and Running Additional Build Agents for detailed instructions.

Connected Agents

An agent is considered connected if it is registered on the TeamCity server and responds to server commands. This status is determined automatically.

This tab displays the agents which are currently connected to the TeamCity server.

Item Description
Agent Displays the available agents. Click an agent link to open the agent details page. Click the column header to sort the table alphabetically by agent name.
Status Displays whether the agent is enabled or disabled, and provides a link to toggle the agent's status. Click the column header to sort the table alphabetically by agent status. Disabled agents are marked with a callout icon. Hovering your mouse cursor over the icon shows summary information:

Running build
Displays information about the build, which this agent is currently running. This information includes:
  • the build configuration's name
  • status of the current build (current task, test passed or failed etc. ) Click the build status link to open the build results page.
  • the build progress bar. Tooltip of the progress bar shows passed and left time of the build.
Stop / Run build
Use this link to stop the selected build.

Disconnected Agents

An agent is considered disconnected if it was once registered on the TeamCity server, but it no longer responds to server commands. This status is determined automatically.

This tab displays the agents which were at some point connected to the server, but currently are not connected. If an agent does not connect to the server for more than two weeks it is removed from the list.

Item Description
Agent Displays the agents that are currently disconnected. Click an agent link to open the agent details page. Click the column header to sort the table alphabetically by agent name.
Status Displays whether the agent is enabled or disabled, and provides a link to toggle agent status. Click the column header to sort the table alphabetically by agent status.
Last registration date Displays the date and time the agent was registered by the TeamCity server.  Click the column header to sort the table by the last registration date.
Inactivity reason
Displays textual description of the agent's inactivity reason. 

Unauthorized Agents

Agents are manually authorized using the web UI. Only authorized build agents can run builds. The number of simultaneously authorized agents cannot exceed the number of agent licenses in your license pool.

This tab displays the agents that are currently not authorized, and a count of available agent licenses.

Item Description
Agent Displays a list of unauthorized agents. Click an agent link to open the agent details page. Click the column header to sort the table alphabetically by agent name.
Authorize
Displays authorization status of an agent and a link to toggle status. Note that the agents registered for the first time are unauthorized by default.
Connection status Displays whether the agent is authorized and connected, and provides a link to toggle the agent's authorization status.
Hostname/IP Displays the agent's IP address or hostname.
Last registration date Displays the date and time the agent was registered by the TeamCity server.  Click the column header to sort the table by the last registration date.
Inactivity reason
Displays textual description of the agent's inactivity reason. 

Agent Statistics

This feature is only available in TeamCity 3.1+

The visual metrics displayed on this page show each build agent's activity over a given time, as well as, which specific builds the agent performed.

On this page you can:

  • Mouse over a build duration to see an overview of the build results in a popup.
  • Navigate to the build configuration home page or the build results by clicking the links on the popup.
  • Select a specific time range by entering new dates (in day-month-year format) and clicking the Update button.
  • Sort the list by agent name or usage using the drop-down list.
Drop-down list item Description
Agent name Sorts agents alphabetically by name from A to Z
Agent name desc Sorts agents alphabetically by name from Z to A
Agent usage Sorts agents by usage from the most inactive to the most active
Agent usage desc Sorts agents by usage from the most active to the most inactive

See also:

Labels