LogoLogo
  • Getting started
    • Welcome
    • Introduction to Multitudes
    • How Multitudes Works
  • Configuration & Setup
    • Setup: Integration Permissions
    • Permissions and roles
    • Adding Users & Teams
    • Configuring your Team
    • User Linking
    • Configuring Working Hours
    • Customize Work Categories
    • Alerts Configuration
    • Customize Targets
  • Metrics & Definitions
    • Multitudes Insights
    • Our Approach to Metrics
    • Process Metrics
      • Flow of Work
        • Change Lead Time
        • Coding Time
        • Review Wait Time
        • Editing Time
        • Deploy Time
        • PR Size
        • Focus Time
      • Value Delivery
        • Deployment Frequency
        • Merge Frequency
        • Types of Work
        • Feature vs Maintenance Work
      • Quality of Work
        • Change Failure Rate
        • Mean Time to Recovery
        • Mean Time to Acknowledge
        • Number of Pages
        • Deployment Failure Rate
    • People Metrics
      • Wellbeing
        • Out-of-Hours Work
        • Page Disruptions
        • Meeting Load
      • Collaboration
        • PR Participation Gap
        • PR Feedback Given
        • PR Feedback Received
        • Feedback Flows
        • Feedback Quality
    • Deployment Metrics
  • Integrations
    • Deployments API
    • GitHub Actions
    • Google Calendar
    • Outlook Calendar
    • Jira
    • Linear
    • Opsgenie
    • PagerDuty
    • Slack
  • Knowledge base
    • Annotations
    • Exporting your data
    • Types of Alerts
      • Daily Blocked PRs alert
      • Trend Summary alert
      • Multitudes AI Coach
      • 1:1 Prompts
      • Annotations alert
    • Troubleshooting Missing Commits
    • Bot Activity
    • Collaborative PRs & All PRs Toggles
  • Account Management
    • Billing & Payments
    • Security & Privacy
Powered by GitBook

© Multitudes 2025

On this page
  • GitHub Actions + Multitudes Integration Benefits
  • How it works
  • Requirements
  • How to install

Was this helpful?

  1. Integrations

GitHub Actions

How to connect GitHub Actions to Multitudes

PreviousDeployments APINextGoogle Calendar

Last updated 2 months ago

Was this helpful?

GitHub Actions + Multitudes Integration Benefits

  • See - how long code takes to get deployed once a PR has been merged and include Deploy Time in calculations

  • See how often code is successfully deployed to Production with ()

  • Keep track of

You can use either our or our GitHub Actions integration to provide us with data about deployments. If you already have our Deployments API integration configured, you will need to revoke that action token before connecting with our GitHub Actions integration.

How it works

on how GitHub Actions data is used to calculate Deployment metrics in Multitudes.

Requirements

Any GitHub organisation admin can set up and configure your GitHub Actions integration.

How to install

  1. In the Multitudes app, go to and click on the Connect button in the Github and Github Actions card

  2. On the resulting modal, click to configure Github Actions data

  3. On the next page of the modal, you can choose either the “Environment/Deployments” or “Workflows” option, based on how you use GitHub Actions. See details below the image.

Don't know what to pick? Here are some common scenarios!

“The change is deployed when it has been deployed to a certain environment/s"

  • This sounds like you are using GitHub Action’s “Environments” feature, and therefore their “Deployments” feature, so you would select "Environment/Deployments"

  • In your case, the best way for us to track a “deployment” is for you to tell us which Environment/s are your production environments in each repository. You'll see this in the next step.

A note on historical data availability: Due to constraints on GitHub’s API, we will not be able to fetch historical deployment data for this option.

  • This is only an issue if you onboarded to Multitudes recently (i.e., if you onboarded to Multitudes a while ago but didn't configure GitHub Actions until today, then today we can still access your historical deployment data).

  • While most charts will have 6 weeks of historical data from before you onboarded onto Multitudes to get you started, charts relating to deployments will only have data from onboarding onwards.

  • Also note that it might look like your Change Lead Time increases from the date that you onboard, because from that point onwards, change lead time will include deploy time based on your deployments data.

  • Here's a concrete example

    • You onboard onto Multitudes (install our GitHub app) on 1 June, from this point on we start accumulating real-time events data

    • We also pull 6 weeks of historical data, back to 16 May, to get you started

    • On 8 June, you configure GitHub Actions

    • We will only show deployment data from June 1 to June 8

“The change is deployed when a specific workflow(s) has run”

  • This sounds like you are not using GitHub Action’s “Environments” feature

  • In your case, the best way for us to track a “deployment” is for you to tell us which Workflow/s are the ones that deploy to your production environment for each repository. You'll see this in the next step.

With respect to data availability in either case, once you have integrated GitHub Actions, we will have real-time data, and will take the first successful attempts to deploy to production going forward (since that is when the change is first available to customers).

  1. Once you’ve made a selection, the following page of the modal will prompt you for further configuration. In either case you will:

  • First identify which repository

  • Then within that repository, select either relevant environment or workflow

  • Click the "Save" button

Screenshot for if you selected “Environment/Deployments

Screenshot for if you selected “Workflows

  1. All done!

Note that within one workflow run, you can have more than 1 successful deployment (e.g., you could use the same workflow to deploy to dev, staging, and prod). Therefore it’s important to understand how we when you’ve selected this option.

A note on historical data availability: we will have access to historical data (the 6 weeks of data from before you onboarded onto Multitudes), but only the latest attempt in the historical data. This means that for example, if an succeeded at 12pm, but for some reason you re-ran the workflow again successfully at 1pm, 1pm will be what is captured as the Deploy Time for that PR, even though it actually got deployed earlier at 12pm. This is a constraint on the historical data from the GitHub API.

calculate deployment metrics
attempt to deploy to production
Deploy Time
Change Lead Time
Deployment Frequency
a key DORA metric
Deployment Failure Rate
Deployments API
See here for details
Settings > Integrations