Agent Details

Agents > click agent name

The contents of this page depend on whether the agent is connected or disconnected from the server.

Connected Agent

Option	Description
Agent summary
Status	This field shows date and time that the agent was connected and enabled/disabled to the TeamCity Server. Use the link to toggle the authorized and enabled/disabled status of an agent.
Details	This field shows the agent's name, host name and IP address, port number, operating system, agent's Agents and current version number.
Running build	This field displays information about the running build. Use the build status link to view build results. See Build Results Home Page page description.
Misc.	Clean sources: Click to enforce deleting old sources from the agent before checking out the sources for the next build to be preformed by this agent. See Clean Checkout. Open Remote Desktop: Click the link to open remote desktop on the current agent. This link is available for connected build agents running on the Windows operating system. For a disconnected agents with Windows OS, the link is available, if TeamCity already got information about agent's OS. The RDP client should be installed and registered on the agent. Reboot Agent Machine: Click to send the reboot signal to the agent machine. This feature is enabled for users who have the specific "Reboot build agent machines" permissions. To enable the feature, it is recommended to set `teamcity.agent.reboot.command` property in the `buildagent.properties` configuration file, thus provide proper reboot command (OS-specific) for the particular agent to ensure it will be rebooted correctly.
Compatible configurations
Current run configuration policy	Displays whether the build agent will run all compatible build configurations or only the build configurations selected from a list. Administrators can set this option using the drop-down list, while users will see the run configuration policy's status and a list of build configurations it will run.
Compatible configurations	This column shows the list of build configurations compatible with this build agent. Click a build configuration name to open Build Configuration Home Page. The number in parenthesis is the number of compatible configurations.
Incompatible configurations	This column shows the list of build configurations that are not compatible with the current build agent, and the reason of incompatibility. Click a build configuration name to open Build Configuration Home Page. The number in parenthesis is the number of incompatible configurations.
all/none hyperlinks	These links are available if the run selected configurations option is selected. For details, see Run Configuration Policy
Build runners	This tab displays information about the build runners that are supported by this agent.
System properties	Use this tab to view the list of properties that can be used for defining build configuration requirements. For more information on system properties and using them see: Properties of a Build Configuration.
Environment variables	Use this tab to view the following kinds of environment variables: defined in the configuration file of the agent defined by the operating system and agent runtime Refer to the Properties of a Build Configuration page for more information on environmental variables and using them.

Disconnected Agent

Option	Description
Agent summary
Status	This field shows the date and time that the agent was disconnected and enabled/disabled. Use the link to toggle the enabled/disabled status of an agent.
Remove agent	Click the button to remove disconnected agent manually. By default, a disconnected agent is removed automatically in 2 weeks after disconnection.
Details	This field shows the agent's name, host name and IP address, port number and operating system.
Clean sources	Click the button to enforce deleting sources from the agent before checking out sources for the next projects built on this agent. See Clean Checkout.

Last modified: 20 April 2023