Sleuth Documentation
HomeBlogSupportSign up
  • Getting started
  • Navigating Sleuth
  • DORA metrics
    • Deploy frequency
    • Change lead time
    • Change failure rate
    • MTTR
    • Interpreting Metrics in Sleuth
  • Deployment tracking
    • Organization
      • Labels
      • Trends
      • Compare
      • Search
      • Status
    • Projects
      • Issue trackers
    • Environments
    • Code deployments
      • Creating a deployment
      • How to register a deploy
      • Rollbacks
      • Automatic tagging
      • Deployment locking
      • Environment drift
      • Move code deployments
      • Search everything
    • Feature flags
    • Manual changes
    • Deploys
    • Teams
  • Work in Progress
  • Goals
  • Sleuth Automations
    • Automations Marketplace
      • Installing Automations
        • Installing PR "Update" Automations
      • Editing and uninstalling Automations
      • Smart suggestions
      • Understanding efficacy
    • Custom Automations
      • Automations Cookbook
      • Webhook Actions
      • Trigger Build Actions
        • Bitbucket Pipelines
        • CircleCI
        • Github Actions
        • Jenkins
  • Slack & Email Notifications
  • Auto-verify deploys
    • Anomaly detection
    • Error impact
    • Metric impact
  • Ignoring pull requests
  • Slack mission control
    • Approvals
    • Project notifications
    • Personal notifications
    • Search Sleuth in Slack
    • Project/Deployment history
    • Developer standup
  • Sleuth API
    • Deploy Registration
    • Deploy import
    • Manual Change
    • Custom Incident Impact Registration
    • Custom Metric Impact Registration
    • Deprecation information
    • GraphQL Queries
    • GraphQL Mutations
    • Query batching
  • Integrations
    • About Integrations...
    • Code integrations (read-only)
      • Azure DevOps
      • Bitbucket
      • GitHub
      • GitLab
      • Custom Git
      • Terraform Cloud
    • Code integrations (write)
    • Feature flag integrations
      • LaunchDarkly
    • Impact integrations
      • Error trackers
        • Bugsnag
        • Honeybadger
        • Rollbar
        • Sentry
      • Metric trackers
        • AppDynamics
        • AWS CloudWatch
        • Custom
        • Datadog
        • Jira metrics (Cloud / Data Center)
        • NewRelic
        • SignalFx
      • Incident tracker integrations
        • Blameless
        • PagerDuty
        • Datadog Monitors
        • Statuspage
        • Opsgenie
        • Jira (Cloud/Data Center)
        • FireHydrant
        • Rootly
        • ServiceNow
        • Custom
          • Grafana OnCall
      • CI/CD builds
        • Azure Pipelines
        • Bitbucket Pipelines
        • Buildkite
        • CircleCI
        • GitHub Actions
        • GitLab CI/CD Pipelines
        • Jenkins
    • Sleuth DORA App for Slack
    • Microsoft Teams integration
    • CI/CD integrations
      • Azure Pipelines
      • Bitbucket Pipelines
      • Buildkite
      • CircleCI
      • Github Actions
      • GitLab CI/CD Pipelines
      • Jenkins
    • Issue tracker integrations
      • Jira Cloud
      • Jira Data Center
      • Linear
      • Shortcut
    • Fixing broken integrations
  • Pulse
    • Welcome to Pulse docs
    • Quick Start setup guide
    • Beginner tutorials
      • 1. How to create a Teamspace
      • 2. How to create a Review
      • 3. How to create a Survey
  • Features
    • Reviews
      • Review workflow
      • Review templates
      • Widgets and Sections
        • Widget type
      • Review settings
    • Surveys
      • Survey Workflow
    • Teamspaces
    • Inbox
    • AI assistant
    • General settings
      • Users and Teams
      • Investment mix
  • Settings
    • Organization settings
      • Details
      • Authentication
        • SAML 2.0 Setup
          • Okta Configuration
          • Azure AD Configuration
          • PingIdentity Configuration
      • Access Tokens
      • Members
      • Team Settings
      • Billing
    • Project settings
      • Details
      • Slack settings
      • Environment settings
      • Code deployment settings
      • Feature flag settings
      • Impact settings
    • Account settings
      • Account settings
      • Notifications settings
      • Identities settings
    • Role Based Access Control
  • Resources
    • FAQ
    • Sleuth TV
    • Purchasing
    • About Sleuth...
Powered by GitBook
On this page
  • Manage Teams Manually
  • Manage Teams using GitHub team Sync

Was this helpful?

  1. Settings
  2. Organization settings

Team Settings

PreviousMembersNextBilling

Last updated 2 years ago

Was this helpful?

The Team Settings tab allows you to optionally define Teams, Sub-Teams, and Team membership. From this tab you can , or if your Teams are already represented in GitHub, then Sleuth can manage your teams automatically using .

For more information on how Teams fit into Sleuth's Deployment tracking data model and why you might want to utilize them in your DORA journey, refer to .

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.

Manage Teams Manually

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

Manage Teams using GitHub team Sync

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.

GitHub Team Sync is only available on the Enterprise plan.

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.

First, ensure that you have as a code repository integration in Sleuth.

Sleuth attempts to link external identities found in GitHub with internal Sleuth users. To view and modify linked external identities, refer to

enabled GitHub
Teams
Members
manage teams manually
GitHub Team Sync
Linking external identities