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
  • About the integration
  • Setting up the integration
  • Configuring the integration
  • Adding more repositories
  • In case of major changes to your GitHub organization
  • Removing the integration

Was this helpful?

  1. Integrations
  2. Code integrations (read-only)

GitHub

PreviousBitbucketNextGitLab

Last updated 1 year ago

Was this helpful?

About the integration

Integrating GitHub with Sleuth is simple. If you're connecting to a personal GitHub repo, you just need your credentials. If you're part of a GitHub organization and aren't the owner, you will need permission to allow Sleuth to connect to the repo (after you connect you'll be able to select individual private or public repositories).

If you are using GitHub issues to track issues, Sleuth will automatically discover your referenced issues once the integration is configured. You can still use other issue tracker integrations if you don't use GitHub issues.

Check out the Sleuth app in the GitHub marketplace.

Setting up the integration

To set up the Sleuth GitHub integration:

  1. Click Add in the top navigation bar and select Integration from the list.

  2. Select Code from the drop-down located in the top right.

  3. In the GitHub tile, click Enable.

  4. Select the account with which you wish to authenticate your GitHub integration.

  5. Select the repositories you wish to grant Sleuth access to by clicking either All repositories or Only select repositories. Note that if you choose Only select repositories, Sleuth will only be able to see and track deploys from the repos you select.

  6. Click Install & Authorize.

  7. Upon successful integration, you'll see GitHub marked as Enabled and a list of connections (you can have more than one) specified in the format Connected via GitHub App (account <GitHub user account> for ______________ repos.

Configuring the integration

After the initial setup is complete, the GitHub integration can be used to set up:

  • a code deployment: select a Sleuth project from the list and then follow the instructions for creating a code deployment

  • a build server: select a Sleuth project from the list to set GitHub as the Build integration provider for the selected project

  • an issue tracker: select a Sleuth project from the list to set GitHub as the Issue integration provider for the selected project

Adding more repositories

If you've selected Only select repositories during your initial setup and now want to give Sleuth access to more repositories, simply navigate to the Integrations page (click the Add button in the top nav and then click Integrations), click the arrow to expand the GitHub tile, and follow the Inspect link next to the connection you wish to update.

This will take you to GitHub installation's page where you can update your preferences.

In case of major changes to your GitHub organization

Making significant changes to your GitHub organization, such as renaming the organization, shouldn't have any effect on your existing GitHub-based code deployments and deploy data in Sleuth.

As per GitHub's official documentation, any attempt to access links containing the old organization name should get automatically redirected.

That being said, if you want to be extra sure, you can always disconnect your GitHub integration in Sleuth and re-connect it after the renaming, which will ensure Sleuth has the most up-to-date org info. You are also welcome to let our Support Team know of this change, so they can help ensure a smooth transition.

Removing the integration

If you wish to remove the GitHub integration for the organization:

  1. Click the Add button in the top nav and select Integrations from the list.

  2. Expand the GitHub integration card, and click Remove next to the connection you wish to remove. If you want to remove all of your GitHub connections, you'll need to repeat this step for each connection. A confirmation screen will appear warning you of the consequences of this action and prompting you to confirm your decision -> click Confirm.

After all connections are removed, the GitHub integration is then disconnected and no longer available for any projects within that organization.