DORA metrics

3 minute read

DevOps Research and Assessment (DORA) metrics can measure the performance of DevOps teams. The CloudBees platform displays each of the four key DORA metrics with an associated percentile performance rating and the percentage change from the previous timeframe.

The four key DORA metrics:

  • Deployment frequency

  • Deployment lead time

  • Change failure rate

  • Mean time to restore (MTTR)

DORA metrics thresholds are configurable.

For any data that is truncated with an ellipsis (…​), hover to display the full content. Use the scroll bars (vertical and horizontal), if necessary, to view the full content.

Access DORA metrics

Filter the four DORA metrics views by duration and by comparing them with other groups or by workflow.

To access and filter DORA metrics views:

  1. Select the next to Analytics on the left pane, select DORA metrics, and then select FILTER.

    Select environment
    Figure 1. Select components, environment, and duration.
    • Select one or more components from the options.

    • Select an environment from the options.

    • Select a Duration from the following options:

      Table 1. Duration filter definitions
      Duration Definition

      Current week

      Current week in the month, Monday to Sunday schedule. For example, if current day is Tuesday, only data from Monday and Tuesday are displayed.

      Previous week

      Previous week in the month, Monday to Sunday schedule.

      Two weeks back

      Two weeks prior in the month, Monday to Sunday schedule.

      Current month

      First day of current month up to current day.

      Previous month

      First day to last day of previous month.

      Two months back

      First day to last day of two months prior.

      Last 7 days

      The past seven days.

      Last 30 days

      The past 30 days.

      Last 90 days

      The past 90 days.

      Custom range

Set a custom date range

View analytics data for any desired time frame, as in the example below:

Custom time frame
Figure 2. Example Custom range selected.

To set a custom date range:

  1. Select FILTER.

  2. Select Custom range.

  3. (Optional) Select the Left chevron to go to a previous month and year.

  4. Select a date for the time frame start.

  5. (Optional) Select the Right chevron to go to a subsequent month and year.

  6. Select a date for the time frame end.

The custom date range is set accordingly and displayed in blue on the date picker.

Customize the dashboard

Customize the dashboard to display only the charts and tables that matter the most to you.

To customize the dashboard:

  1. Select Analytics on the left pane, and then select the dashboard.

  2. Select the Vertical ellipsis on the top right of the dashboard.

  3. Select Edit dashboard.

  4. (Optional) Remove a chart or table from the dashboard.

    1. Select the next to the chart or table you want to remove.

    2. Select SAVE.

  5. (Optional) Add back a chart or table to the dashboard.

    1. Select ADD FROM LIBRARY to display a list of the available charts or tables.

    2. Select ADD TO DASHBOARD next to the item you want.

    3. Select APPLY.

  6. (Optional) Rearrange the items on the dashboard.

    1. Select the Move icon on a chart or table you want to move.

    2. Drag the item to a different location on the dashboard.

System health and runs overview
Figure 3. Editing a dashboard, with move and remove icons highlighted.

The dashboard is customized accordingly.

Only those charts and tables with a in their upper-right corner can be edited.

Prerequisites

  1. Specify the kind as kind:deploy in the workflow YAML for your deployment operations, as noted in Manage workflows.

  2. You must have at least one environment defined.

Example data ingestion
Figure 4. Specify the environment on the job level.

Explore Deployment frequency and MTTR

4 key metrics
Figure 5. Explore four key Dora metrics.
  1. Deployment frequency: The reading depicts the average number of successful deployments for the selected component and environment, per day.

    Example of successful deployments
    Figure 6. Example Successful Deployments list.

    Select the Average per day number links to display a list of successful deployments, for the selected Component and Environment.

    Each list includes:

    • Run Id

    • Run start time (UTC)

    • Deployed on (UTC)

    • Lead time

    • Component

    • Workflow

  2. Deployment Lead time: The reading depicts that it takes four minutes and two seconds to deploy from the time the PR is approved.

  3. Change failure rate:The reading tells what percentage the deployments have failed for the selected component(s) and duration to the selected environment.

  4. MTTR: The reading depicts how much time it takes for the failed deployments to resolve.

Explore Deployment frequency and Lead time trend

Example deploy frequency
Figure 7. Example Deployment frequency and Lead time trend charts.

The above graph displays the successful deployments and deployment lead time over weeks when the user selects month duration. If the user selects week duration, it shows the data per day.

Explore Failure rate and MTTR trend

Example failure rate
Figure 8. Example Failure rate and Mean time to recover trend charts.

The above graph displays the Failure rate and mean time to recovery over weeks.