Project metrics

Overview

This category contains documentation topics about LaunchDarkly's engineering insights project metrics. The project summary provides an overview of several metrics to help you track and optimize your deployments and releases.

Metrics summary

The "Summary" section provides high-level ratings in the following categories:

• Release maturity: an overall rating calculated using the project's velocity, risk, and efficiency scores
• Velocity: calculated using your project's deployment frequency and lead time
• Risk: calculated using your project's failure rate and change impact size
• Efficiency: calculated using your project's flag health and Experimentation rate, if applicable

Here is an example project summary with ratings for each area:

Each category is rated on a scale from 1-100, using the following categories:

• Excellent: 90-100
• Good: 70-89
• Fair: 40-69
• Needs attention: 0-39

The sections below explain the individual metrics that LaunchDarkly uses to determine your project ratings.

Metrics

In LaunchDarkly, a deployment is a new code change your team has introduced to an environment, and a release is when you change how customers experience your application. These metrics are often significantly different for teams that have adopted feature flagging, so you need to track both to fully understand how and when changes are going out to your customers.

You can refine your dashboard view by narrowing by project, environment, application, and date range:

To provide insight on speed and stability for both deployments and releases, the project summary includes the following categories.

Velocity

The velocity category includes the following metrics:

• Deployment frequency: The number of deployments per time period. This page includes a table of recent deployments, total rollback deployments, their details, and their statuses. To learn more, read Deployments.
• Lead time: The time from first code commit to deployment. This page breaks the total lead time into steps, including coding time, pull request (PR) lifespan, deployment wait time, and deployment duration. It also includes a table of recent PRs and the environments you deployed them to. To learn more, read Lead time.

Risk

The risk category includes the following metrics:

• Deployment failure rate: The number of deployments that were rolled back per time period. To learn more, read about the deployments list.
• Large-impact flag changes: The number of flag changes that had a significant impact on your end users. To learn more, read Releases.

Efficiency

The efficiency category includes the following metrics:

• Stale flags: The ratio of stale flags to the total number of temporary flags for the selected environment. This page includes a summary of stale flags and recommendations for which flags can be removed. To learn more, read Flag health.
• Experimentation rate: The number of flag changes that are associated with an experiment. This page includes a table of recent flag changes by change type and flag key. To learn more, read Experimentation rate.