Viewing Build Agent Details

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:

Agent Summary

• Status: Build Agent.

• Details: the agent's name, host name and IP address, port number, operating system, the agent's CPU rank, the Agent Pools the agent belongs to, and the current version number.

• If there is a build currently running on the agent, the page displays information on the build with the link to the Working with Build Results.

• Miscellaneous: this section provides the options to

  • Clean Checkout

  • 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.

    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.command agent configuration parameter to the Build Agent Configuration file with the command to execute when reboot is required. Example configuration:

    teamcity.agent.reboot.command=sudo shutdown -r 60 or teamcity.agent.reboot.command=shutdown -r -t 60 -c "TeamCity Agent reboot command" -f

  • Dump threads on agent.

Build History

Shows the builds that were run on the agent

Compatible Configurations

Displays compatible and incompatible build configurations with the reason of incompatibility.

Build runners

Lists build runners supported by build agent.

Agent logs

The page allows viewing and downloading the logs.

Agent Parameters

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.