GitLab
Produit & IngénierieSix GitLab KPIs selected to drive engineering team delivery velocity and CI reliability, with the selection criteria made explicit.
Six GitLab KPIs selected to drive engineering team delivery velocity and CI reliability, with the selection criteria made explicit.
| Indicator | Object | Type | Formula | Unit |
|---|---|---|---|---|
| MR Cycle Time Average time from merge request creation to merge, in hours. | Merge_request | Leading | AVG(cycle_time_hours) | hours |
| MRs Merged Number of merge requests merged. | Merge_request | Lagging | COUNT | count |
| Issue Cycle Time Average time from issue creation to closure, in days. | Issue | Lagging | AVG(cycle_time_days) | days |
| Overdue Issues Number of open issues past their due date. | Issue | Leading | COUNT | count |
| Pipeline Success Rate Ratio of successful pipelines over total pipelines triggered. | Pipeline | Leading | COUNT_RATIO | % |
| Deployment Frequency Number of successful deployments per week. | Deployment | Lagging | COUNT | count |
GitLab exposes a wide range of objects: issues, merge requests, pipelines, deployments, commits, jobs, projects, and groups. This integration covers four object types — merge requests, issues, pipelines, and deployments — which together span the full engineering value chain from code authorship to production release. Commits were evaluated and excluded: line-count and commit-frequency metrics fail the gaming resistance criterion and carry no causal link to delivery quality. Six KPIs were retained, selected against three criteria: ability to attribute to an owner, resistance to gaming, and balance between leading and lagging indicators.
MRs Merged counts the number of merge requests an author has shipped into the codebase. MR Cycle Time measures the average elapsed time from merge request creation to merge. These two indicators maintain an explicit tension. A high MRs Merged count confirms delivery throughput, but says nothing about the quality of the review process: a developer who merges many small, poorly reviewed requests will score well on volume while accumulating technical debt and introducing regression risk. MR Cycle Time counterbalances this: a short cycle time reflects well-scoped, reviewable work and an efficient review loop, two conditions that are structurally difficult to fake. A developer who artificially splits their code into minimal MRs to reduce cycle time achieves the underlying engineering goal rather than gaming the metric. Reading both indicators together identifies a distinct pattern in each quadrant: high volume with short cycle time characterizes a developer working in a healthy rhythm; high volume with long cycle time may indicate scope creep or bottlenecks in the review chain; low volume with short cycle time suggests infrequent but well-executed delivery; low volume with long cycle time points to execution difficulties or poorly framed work items.
Issue Cycle Time measures the average duration between issue creation and closure for a given assignee. It is the primary lagging indicator of individual work throughput, and the engineering equivalent of a sales cycle duration. A long Issue Cycle Time, sustained across multiple periods, reveals one of two systemic conditions: either issues are poorly scoped and grow in complexity during execution, or the assignee is context-switching across too many parallel items to maintain flow. Issue Cycle Time alone does not distinguish between these two causes.
Overdue Issues provides the leading counterpart. It counts open issues that have passed their due date, surfacing commitments slipping before the cycle time lagging signal fires. An isolated overdue issue carries limited signal. A sustained accumulation of overdue issues, particularly in a period where Issue Cycle Time is also lengthening, confirms a structural backlog problem rather than a scheduling anomaly. The assignee can act on Overdue Issues directly — by reprioritizing, rescoping, or escalating — whereas Issue Cycle Time is only readable in retrospect. The combination of the two indicators distinguishes between operational drift that can be corrected in real time and structural delivery failure visible only after the fact.
Pipeline Success Rate measures the proportion of pipelines triggered by a developer that complete successfully. It is a leading indicator of code quality at the point of integration: a developer whose pipelines fail frequently is shipping work that breaks the test suite or violates build constraints, two conditions that impose costs on the entire team. This indicator is attributable at the individual level because GitLab records the user who triggered each pipeline, enabling a per-contributor view of CI health. The gaming risk is low: a developer cannot easily influence the success rate without actually improving the quality of the code submitted.
Deployment Frequency, the fourth DORA metric tracked in this integration, counts successful deployments attributable to a user over a given period. Where Pipeline Success Rate measures readiness to ship, Deployment Frequency confirms that shipping actually occurs. The two indicators in combination reveal the full CI/CD picture: a high Pipeline Success Rate paired with low Deployment Frequency may indicate that the team's integration process is healthy but that releases are bottlenecked at the deployment stage by non-technical factors such as change management gates or release scheduling. Conversely, a high Deployment Frequency paired with a declining Pipeline Success Rate signals that release cadence is being maintained by lowering the quality bar at integration, a common pattern under sprint-end pressure.
GitLab records state transitions and user attributions, but does not measure the quality of the work produced. A merged request may represent a well-architected change or a quick workaround that accumulates technical debt; the API data does not distinguish between the two. Pipeline Success Rate measures conformance to existing tests, not the completeness of the test suite itself: a developer with a high success rate in a project with low test coverage is receiving a weaker quality signal than the same indicator would suggest in a well-tested codebase. Deployment Frequency is meaningful only in contexts where the team controls their deployment process; in organizations where releases are gated by external approval processes, the metric reflects organizational policy as much as individual performance.
User attribution also carries a structural limitation on GitLab.com: email addresses may be set to private, which constrains the matching of GitLab users to Human Bridge accounts. The integration resolves attribution via user identifiers available in the API, but the reliability of this resolution depends on consistent email configuration across the team. More broadly, these KPIs capture only what is recorded in GitLab: code review conversations conducted outside the platform, architectural decisions made in meetings, and mentoring activity leave no trace in the data. The reliability of all six indicators depends directly on the team's discipline in using GitLab as the authoritative record of engineering work.
No sign-up required and from your company's public data, we'll build a tailored scenario. Within a few hours, you'll receive an email with your access link.
We're preparing your personalized preview and will email you the link shortly.