For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Sign inTry it free
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
  • Get started
    • Overview
    • Onboarding
    • Get started
    • Launch Insights
    • LaunchDarkly architecture
    • LaunchDarkly vocabulary
  • AgentControl
    • AgentControl
    • Manage AgentControl
  • Feature flags
    • Create flags
    • Target with flags
    • Flag templates
    • Manage flags
    • Code references
    • Contexts
    • Segments
  • Releases
    • Releasing features with LaunchDarkly
    • Release policies
    • Percentage rollouts
    • Progressive rollouts
    • Guarded rollouts
    • Feature monitoring
    • Release pipelines
    • Engineering insights
      • Get started with engineering insights
        • Send deployment information
        • Install the GitHub app
        • Set up code references
        • Applications in Engineering insights
      • Project overview
      • Project metrics
    • Release management tools
    • Applications and app versions
    • Change history
    • Restoring previous flag versions
  • Observability
    • Observability
    • Session replay
    • Error monitoring
    • Logs
    • Traces
    • Observability metrics
    • Product analytics events
    • LLM observability
    • Alerts
    • Dashboards
    • Service map
    • Vega for auto-remediation
    • Observability MCP server
    • Search specification
    • Observability settings
    • Observability integrations
  • Experimentation
    • Experimentation
    • Experiment metric types
    • Experiment configuration
    • Managing experiments
    • Analyzing experiments
    • Multi-armed bandits
    • Holdouts
  • Metrics and events
    • Metrics in LaunchDarkly
    • Creating metrics
    • Metric groups
    • Events
    • Autogenerated metrics
  • Warehouse native
    • Warehouse native metrics
    • Setting up external warehouses
    • Creating experiments using warehouse native metrics
  • Infrastructure
    • Connect apps and services to LaunchDarkly
    • LaunchDarkly in China and Pakistan
    • LaunchDarkly in the European Union (EU)
    • LaunchDarkly in federal environments
    • Public IP list
  • Your account
    • Projects
    • Views
    • Environments
    • Tags
    • Teams
    • Members
    • Roles
    • Account security
    • Feature previews
    • Billing and usage
    • Changelog
Sign inTry it free
LogoLogo
On this page
  • Overview
  • Install the GitHub app
  • Associate repositories with projects
  • Additional setup
ReleasesEngineering insightsGet started with engineering insights

Install the GitHub app

Was this page helpful?
Previous

Set up code references

Next
Built with

Overview

This topic explains how to install the GitHub app for engineering insights and how to associate repositories and projects.

Adding the LaunchDarkly GitHub app to your existing GitHub organization lets engineering insights track pull request and commit frequency and timing. Engineering insights uses this information to calculate deployment lead time and other metrics.

Install the GitHub app

To install the LaunchDarkly Engineering Insights GitHub app:

  1. Click Get started at the bottom of the screen. A menu appears.
  2. Click Connect to GitHub. The setup screen appears.
  3. Click Install now from the “Source control” section.
Engineering insights does not request or store your source code

The GitHub app asks for read access to code, metadata, and pull requests for the repositories you select. LaunchDarkly does not request or store any code contents, only pull request and commit metadata.

  1. Follow the OAuth workflow to install the app automatically. After you accept the installation, you are redirected back to LaunchDarkly.

After you install the app, activity data for the repositories you chose will flow into LaunchDarkly. Historical data from the repositories will populate automatically.

Associate repositories with projects

LaunchDarkly automatically creates repository associations when it receives deployments or code references. Optionally, you can manually configure additional associations. This allows you to see code-based metrics before you send deployments.

To associate repositories with projects before sending deployments:

  1. From within engineering insights, click your display picture and choose “Connect code repositories” from the menu.

    If you haven’t sent any pull requests yet, then the lead time setup card will be empty. In this case, you can click View repository associations from the lead time setup card.

  2. In the Repository menu, select a repository.

    Only the repositories that you selected when you installed the GitHub app are available. To add more repositories, adjust the settings for the GitHub app in your GitHub account.

  3. In the Project name menu, select a project. All of your LaunchDarkly projects are available.

  4. Click Save configuration.

The "Associate repositories with projects" setup screen.

The "Associate repositories with projects" setup screen.

To remove an association, click the x next to the project name you want to disassociate.

Additional setup

To finish setting up engineering insights, you may also need to Send deployment information and Set up code references. To learn more, read Confirm your setup.