A few important things to note about Sleuth Teams:
- All team members in Sleuth must be licensed Contributors (or above). Standard plans include up to 50 Contributors, while Enterprise plans provide unlimited Contributors.
- One Member can belong to multiple Teams
- One Team can contribute to multiple Projects, and multiple Teams can contribute to the same Project (e.g. a platform team contributing to multiple Projects, or multiple micro-services Teams contributing to the same Project)
- Sleuth does not require users to explicitly associate Teams with Projects. Rather, Sleuth attributes Project-level metrics with Teams by looking for Team involvement in your underlying Deploys across Projects. Since Team's DORA metrics are calculated as an aggregation of all teams members' contributions to deploys, if a team member moves teams, then their “contributions” move with them. For more information on how Sleuth calculates Team-level metrics, refer to How Sleuth Calculates Team-level Metrics.
To manually add Teams, Sub-Teams, and associated team Members, perform the following steps.
- From the Team Settings tab under Organization Settings, click Add Team
- Enter a Team name and leave the Parent team field empty.
- Click Save
- In the following screen, select the Sleuth Members you'd like to associate with this Team. This screen presents only existing Sleuth users, so if you can't find the user you're looking for, invite them to Sleuth using the Members tab
- To add a Sub-Team to this Team, repeat the prior steps, but select the first team as the Parent team for your sub-team. Sleuth will present your Teams and Sub-Teams in a collapsible/expansible tree structure.
If you're already managing your teams in GitHub, GitHub Team Sync can automatically keep your Teams, Sub-Teams, and Team Members in sync with changes you make in GitHub. This is particularly useful for customers managing many teams.
Note that when using GitHub Team Sync, GitHub is the source of truth for team structures, and when enabled, you will not be able to add, edit, or delete teams, sub-teams, or team members from within Sleuth. If you have teams already defined in Sleuth, those teams will be deleted from Sleuth and replaced by the team data that Sleuth receives from GitHub.
To enable GitHub Team Sync, perform the following steps:
- Once you've verified that the GitHub code repository integration is enabled, from the Teams tab under Organization Settings, click the Manage teams using GitHub toggle to enable it.
- If you have multiple GitHub organizations integrated with Sleuth, use the toggles to specify which GitHub organizations to include or exclude from Team Sync.
- If you've already created teams manually in Sleuth, you will be presented with a warning that those teams will be deleted. Click Enable Sync.
- Sleuth will display a progress icon, and once the sync is complete, Sleuth will display the date and time when the last sync completed. Once complete, you should see all of your GitHub teams, sub-teams, and team memberships reflected in Sleuth.
- Sleuth will automatically refresh your GitHub teams every 24 hours at 2:00am UTC, but you can also force a refresh at any time by clicking Sync now. However, please note that the Sync now button can be used only once every 30 minutes.