Scout Trails Docs

Teams

A team is a named group of actors inside your organization. Teams let you look at the combined tool calls, sessions and spend of a group of machines and agents, for example everything your platform engineers’ laptops and CI runners produce. Teams contain actors, not members: you add the actors that send telemetry, not the people who sign in.

Any member can view teams. Only admins can create and delete teams and change who is on them.

The Teams page

Manage → Teams lists every team in the organization. The All teams table shows:

  • Team: the team name. Selecting it opens the team’s dialog.
  • Actors: how many actors are on the team, including deactivated actors.
  • An unlabelled last column with a Manage button that also opens the team’s dialog. Admins also see Delete there.

If the organization has no teams, the page says “No teams yet.” Admins see Create the first team; members see “An admin of this organization can create one.”

Creating a team

You must be an admin.

  1. Open Manage → Teams.
  2. In the New team card, enter a Team name of up to 120 characters.
  3. Select Create team.

Team names must be unique within the organization. If the name is taken, the page shows “A team named name already exists.” A team cannot be renamed after it is created.

The team dialog

Selecting a team’s name, or Manage on its row, opens a dialog over the Teams page. The dialog shows the team name, how many active actors are on it, and a list of those actors with each one’s display name, kind and role label. Deactivated actors are not counted or listed in the dialog, though the Actors column on the Teams page still includes them. A team with no actors says “No actors on this team yet.” Members see the list only; admins can also add and remove actors there.

A link to /manage/teams/<team id> opens the Teams page with that team’s dialog open.

Adding actors to a team

You must be an admin.

  1. Open Manage → Teams and select the team, or select Manage on its row.
  2. In the Add an actor field at the bottom of the list, start typing an actor’s display name or kind, for example “CI” or “agent”. Matching actors appear below the field.
  3. Select the actor, or highlight it with the arrow keys and press Enter.

The actor is added straight away. The page reloads with the team’s dialog open and the banner “Actor added to the team.”

The suggestions offer every actor in the organization that is not already on this team. When every actor is already on the team, or the organization has no actors, the last row says “Every actor in this organization is already on this team.” An actor can belong to more than one team.

With JavaScript turned off, the last row is an Add an actor list instead. Choose the actor and select Add.

Removing actors from a team

You must be an admin.

  1. Open the team’s dialog.
  2. Select Remove on the actor’s row. A dialog titled Remove actor from team? asks you to confirm.
  3. Select Remove to go ahead, or Cancel to return to the team’s dialog and leave the roster unchanged.

The page reloads with the team’s dialog open and the banner “Actor removed from the team.” Removing an actor from a team does not change the actor, its ingest key, or its telemetry.

Deleting a team

You must be an admin.

  1. Open Manage → Teams.
  2. On the team’s row, select Delete. A dialog titled Delete name? asks you to confirm.
  3. Select Delete to go ahead, or Cancel to close the dialog and leave the team unchanged.

The banner confirms “Team deleted.” Deleting a team removes the grouping only. The actors on it, their ingest keys and all telemetry are unchanged.

How teams affect the dashboard

The Overview, Sessions, Tool calls and Trends pages have a Scope control with three kinds of option:

  • Whole organization: everything the organization has recorded.
  • Teams: one option per team. Selecting a team shows telemetry from the actors on that team.
  • Actors: one option per actor. While a team is selected, this group lists only that team’s actors.

Scope narrows what you are looking at; it does not restrict access. Every member can select every team and every actor.

A team’s view is based on who is on the team when you look. Adding an actor to a team brings that actor’s earlier telemetry into the team’s view too, and removing an actor takes its telemetry out of the team’s view. A team that has never had any actors shows no data.

See The dashboard for the pages that carry the Scope control.