> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codeant.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Azure DevOps Repo DORA Metrics

> Compute and Analyze DORA Metrics for Your Azure DevOps Repository

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

***