Skip to main content

Overview

The OrgDORAMetricsAzureDevOps module uses Azure DevOps REST APIs to aggregate build, pull request, and work item data across all projects in an organization. It provides organization-wide insights into delivery performance and resilience without exposing low-level implementation details.

Authentication & Permissions

  • Personal Access Token (PAT)
    • Build: Read access to query pipeline runs
    • Code: Read access for pull requests and commits
    • Work Items: Read access to query incident-related work items
  • Service Principal / OAuth Token
    • Grant equivalent scopes for Builds, Git, and Work Items APIs
    • Ensure the token is valid for the target organization and all its projects

Metrics

Deployment Frequency

  • Total number of successful pipeline runs on the main branch across all projects within the selected date range.

Lead Time for Changes

  • Average time from pull request creation to successful pipeline completion on merge, aggregated at the organization level.

Change Failure Rate

  • Proportion of pipeline runs triggered by pull request merges that resulted in failure or partial success.

Mean Time to Recovery (MTTR)

  • Average time to resolve work items labeled as incidents, measured across the organization.

First Review Time

  • Average time from pull request creation to the first review comment, aggregated across all repositories.

First Approval Time

  • Average time from pull request creation to the first approval vote, aggregated across all repositories.

First-to-Last Approval Time

  • Average interval between the first and last approval vote on each pull request, across the organization.

Last Approval-to-Merge Time

  • Average duration from the final approval vote to the merge event for all pull requests across the organization.

Time to Open

  • Average time between the first commit in a pull request branch and the pull request’s creation, with negative intervals zeroed out.

Time to Merge

  • Average duration from pull request creation to merge completion, aggregated at the organization level.