To view the state and information about an agent, click its name or navigate to the Agents page, find the agent in the list of connected, disconnected or authorized agents and click its name.
For each connected agent TeamCity provides the following information:
- Status: learn more about an agent's status.
- the agent name
- the agent host IP address
- the port used by the TeamCity server to connect to the agent
- the communication protocol used for data transfers between the agent and the server
- the agent operating system
- CPU rank: the result of the bundled CPU benchmark. Note that the benchmark results can depend on the JVM version and options used by the agent. For example, '-server' JVM option has a significant influence on the results. CPU benchmark also affects the way how the server distributes builds among agents. If a build duration estimate cannot be calculated for an agent (there were no builds in the history ran on this agent), TeamCity chooses the fastest agent basing on the CPU benchmark value.
- the pool the agent belongs to
- the agent launcher version
- If there is a running build on the agent, the page displays information on the build with the link to the build results.
- Miscellaneous: this section provides the options to
- Clean sources on the agent
- Open Remote Desktop: available for agents running on the Windows operating system if the RDP client is installed and registered on the agent.
Reboot Agent Machine: available to users with Reboot build agent machines permissions. Click the link and confirm the reboot action. By default, the TeamCity agent will wait until the current build finishes. Deselect the checkbox and click Reboot to restart the agent immediately.
Additional configuration of the reboot command is possible.Click to view details.
Configuring Agent Reboot Command
Agent reboot is performed by executing an OS-specific command.
Under certain circumstances the command might need customization specific to the OS environment. Additional configuration might be required if the default reboot command fails.
To tweak agent reboot, add the
teamcity.agent.reboot.commandagent configuration parameter to the
buildagent.propertiesfile with the command to execute when reboot is required.
- Dump threads on agent.
Shows the builds that were run on the agent
Displays compatible and incompatible build configurations with the reason of incompatibility.
Lists build runners supported by build agent.
The page allows viewing and downloading the logs.
The tab lists system properties, environment variables, and configuration parameters. Refer to the Configuring Build Parameters page for more information on different types of parameters.