​
Overview

This module leverages Azure DevOps REST APIs to compute key DORAMetrics.

​
Authentication & Permissions

  • Personal Access Token (PAT)
    • Must have Build (read) to query pipeline runs.
    • Code (read) for pull request and commit data.
    • Work Items (read) to fetch incident resolution dates.
  • Service Principal / OAuth
    • Grant equivalent scopes to access Builds, Git, and Work Items APIs.
Ensure the token or service connection is scoped to your organization and project for seamless data access.

​
Metrics

​
Deployment Frequency

  • Number of successful pipeline runs (builds) on the target branch within the date range.

​
Lead Time for Changes

  • Average time from pull request creation to build completion on merge.

​
Change Failure Rate

  • Proportion of merged pull requests whose first build failed or partially succeeded.

​
Mean Time to Recovery (MTTR)

  • Average time to resolve work items labeled as incidents.

​
First Review Time

  • Average time from pull request creation to the first non-system comment.

​
First Approval Time

  • Average time from pull request creation to the first approval vote.

​
First-to-Last Approval Time

  • Average interval between the first and last approval votes on each merged pull request.

​
Last Approval-to-Merge Time

  • Average time from the final approval vote to merging the pull request.

​
Time to Open

  • Average time between the earliest commit in a PR branch and pull request creation (negative values zeroed).

​
Time to Merge

  • Average duration from pull request creation to merge/completion.