Setup DORA Metrics

Includes all information for a VSM admin to setup VSM for a growing community

Prerequisites

To enable the DORA metric calculation, your team needs to be present in the VSM workspace, along with its team members and the services it owns.
Furthermore, release and incident data need to be provided, either via the Github integration or the custom events API.

Teams

The metrics are calculated on a per-team basis, visible on a separate tab for the team.

1124

Team Members

Adding team members to your team is another requirement as this makes it possible to match individual commits and releases to the team.

2560

Services

Creating services from GitHub repositories or other sources, and linking them to the owning team is the final step to calculate your metrics.

1192

Metric Calculation

DORA Metrics are calculated on the fly each time new change, release and incident events are received and the requirements mentioned above are met. In case the events for services/members that do not exist in VSM are received, no metric can be calculated. In this case, the events are still stored and the metrics will be calculated, when the matching services, teams and members are added.

Once you have an initial setup of teams, members and services, the events containing the data for individual metrics are needed. If you are using GitHub, the VSM Github Integration provides this data automatically. Otherwise, the custom events API provides a way to send this data independent of the source.

Out-of-the-Box Integrations

When using our out-of-the-box GitHub integration, the corresponding change and release events are automatically generated.

Custom Events API

To add release, change and incident data from sources other than Github, VSM provides a custom events API. The documentation can be found here: DORA Custom Events API


What’s Next