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

Select your repository

Details required to configure DORA are: Repository, Deployment tracking, and Change failure tracking.

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.

Add your deployment tracking

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

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

  2. 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. Github Actions: If you use Github actions, select your Action from the dropdown and the method.

  4. Gitlab Pipelines: If you use Gitlab pipelines, select the relevant job from the pipleline.

Change Failure Tracking

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.

Add more

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

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

You can configure DORA metrics for multiple repositories, all at once.