Check your agents

Agents are the machines that run your tests. To see whether you currently have agents that can receive and run tests, go to the Agents page.

Agents page. Click to enlarge.

Here's what you can do on the page:

Check agent availability

What and how many agents are available to you depends on how your administrator has set up your organization's Tosca Cloud instance. You may have cloud agents, team agents, personal agents—or any combination thereof.

  • The Name section shows how many agents are in your organization's plan. For cloud agents, that means how many are actually available. For team agents, that means how many are available theoretically. Your organization may have fewer or no team agents.

  • The Ready section lists all agents that are either available and ready to run tests or already running tests.

  • The Unavailable section shows all agents that are currently disconnected. These agents can't run tests.

Check agent details

The Agents page gives you important information at a glance:

  • Which characteristics the agent has. If the playlist you want to run requires certain characteristics, you need agents that are ready and have matching characteristics.

  • When it was last updated. Agents update when they switch between connected and disconnected states, or when you restart them. If you run into unexpected errors during a test run, check the Last update column. Maybe the agent machine rebooted or disconnected for some reason.

Select an agent on the list to get additional information:

  • Screenshots of the agent interface, if the agent is a team agent and the live view setting is active on the agent machine.

  • The agent's complete list of characteristics, if there wasn't enough space for it on the main page.

Agent details. Click to enlarge.

Remove disconnected agents

An agent that's not communicating with Tosca Cloud shows up as Disconnected. Tosca Cloud automatically removes it from the list after 24 hours, so that the page doesn't clutter up.

If you want to remove a disconnected agent sooner, hover over it and select Remove agent. Don't worry, this doesn't delete or uninstall the agent.

To remove an agent that's currently connected, you need to disconnect it first. Simply close the agent window on the agent machine. After that, you can remove the agent from the Agents page.

Reconnect agents

It doesn't matter whether your agent shows up as Disconnected or not at all on the list. To reconnect the agent, do this:

  • If it's a team agent, restart it. After that, the agent is ready to receive and run tests.

  • If it's a personal agent, start a trial run. This automatically restarts and reconnects the agent.

  • If it's a cloud agent, you don't have to do anything. Cloud agents start up automatically whenever you trigger a test run.

What's next

Once you know that you have agents that can run your tests... run your tests.