This documentation relates to an earlier version of Bamboo.
View

Unknown macro: {spacejump}

or visit the current documentation home.

On this page:

A Bamboo agent is a service that provides capabilities to run Job builds. There are two types of Bamboo agents:

(info) Local agents run in the server's process, i.e. in the same JVM as the server. Each remote agent runs in its own process, i.e. has its own JVM.)

To view only agents which are currently active, see Viewing Bamboo's Current Activity.

Viewing All Available Bamboo Agents

To view all of Bamboo's available agents,

  1. Click the 'Home' link in the top navigation bar. This opens the Dashboard.
  2. Navigate to the 'Current Activity' tab of the Dashboard.
  3. Click the 'X of Y online agents are building' link in the 'Building' section of the page.
    (info) 'X' is the number of online agents that are currently building Bamboo builds and 'Y' is the total number of available online agents.

    Screenshot: Accessing the List of All Bamboo Agents

  4. A list of all agents in your Bamboo system will be displayed (see screenshot below).
    Screenshot: View Agents

Viewing a Specific Bamboo Agent as a Bamboo User

To view a specific agent as a standard Bamboo user,

  1. Click the 'Home' link in the top navigation bar. This opens the Dashboard.
  2. Navigate to the 'Current Activity' tab of the Dashboard.
  3. Click the name of the agent you wish to view in the 'Building' section of the page. To access the name of the agent, you can either:
    • Click its name in the list of builds as shown in the following screenshot:
      Screenshot: Accessing the Agent Name in the List of Builds

    • Click the 'X of Y online agents are building' link in the 'Building' section of the page to view the list of all Bamboo Agents.
      (info) 'X' is the number of online agents that are currently building Bamboo builds and 'Y' is the total number of available online agents.
      • Click the name of an agent in the 'Local Agents' section of this page (see screenshot below).
        (info) You can view agents listed in the 'Remote Agents' or 'Elastic Images' sections of this page by clicking their names too. However, you will require Bamboo administrator permissions to access these details. Upon clicking one of these agent's names, you may be prompted to log in to Bamboo.
        Screenshot: Choosing an Agent on the List of All Bamboo Agents Page

  4. The details of the selected agent will be displayed. If you have not changed the default view, the 'Recent Builds' view will be shown. If not, click the 'Recent Builds' tab.
    Screenshot: View Agent

    • You can click on the 'Executable Plans' tab to view the plans that this agent is capable of building.
      Screenshot: View Agent - Executable Plans

    • You can also click on the 'Capabilities' tab to view the capabilities of this agent.
      Screenshot: View Agent - capabilities

Viewing a Specific Bamboo Agent as a Bamboo Administrator

To view a specific agent as a Bamboo administrator,

  1. Click the 'Home' link in the top navigation bar. This opens the Dashboard.
  2. Navigate to the 'Current Activity' tab of the Dashboard.
  3. Click the name of the agent you wish to view in the 'Building' section of the page. To access the name of the agent, you can either:
    • Click its name in the list of builds as shown in the following screenshot:
      Screenshot: Accessing the Agent Name in the List of Builds

    • Hover your mouse pointer over the 'X of Y online agents are building' link and in the resulting popup, click on the agent's name as shown in the following screenshot:
      (info) 'X' is the number of online agents that are currently building Bamboo builds and 'Y' is the total number of available online agents.
      Screenshot: Accessing the Agent Name via the Popup

  4. The details of the selected agent will be displayed in the Bamboo administration console, where you can further configure this agent and its capabilities. By default, the 'Capabilities' view will be shown. If not, click the 'Capabilities' tab.
    Screenshot: View Agent

    • You can click on the 'Executable Plans' tab to view the plans that this agent is capable of building.
      Screenshot: View Agent - Executable Plans

    • You can also click on the 'System Properties' tab to view the system properties of this agent.
      Screenshot: View Agent - System Properties



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.