How to configure the DORA metrics dashboard?

DORA metrics dashboard showcases deployment frequency, change failure rate, mean time to restore (mttr), and cycle time of deployed code.

It works based on the deployments that occur in your code base and how fixes are implemented.

Hatica integrates with a number of CI/CD tools and provides configuration in-app to choose the CI/CD tool, the app id of your deployment pipeline, and the REGEX used to track failures on PR title or PR Labels.

Follow these steps to configure a project to populate DORA metrics:

Invoke the add new DORA config modal

Head over to the DORA metrics config page found under Settings page (link: https://app.hatica.io/settings/metrics/dora).

To begin adding a new config, click on the "Add new DORA config" button on the top right of the DORA metrics settings page

Add details and hit Done

Details required to configure DORA are:

  1. Repository: Pick a repository you wish to see DORA metrics for. The list of repositories are imported from your Git based integrations. If you do not find a repository, please make sure you've added the repository while integrating Hatica with your Git app.

  2. Deployment Tracking: Pick your way of deployments. We provide 3 options to track your deployments:

    1. Connected app: For example, Github Actions, Jenkins, etc.
      Select your app, and add the Action ID that corresponds to this repository's deployment.

    2. Push to branch: You can configure pushing/merging to a branch as a deployment with this option. Input needed here is the name of the branch.

    3. Events API: In other cases, you can integrate our Events API with your deployment workflow where you can call our EventsAPI to populate deployments on DORA dashboard

  3. Change failure tracking: If there's a failure, the PR label or PR title used to differentiate the fix is required to track the failures. Note, these are regular expressions (Regex), which means, just the pattern used is sufficient.

Once these are added, hit the Done button to save your configuration.

DORA dashboard will populate the relevant metrics from your next deployment.