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:
-
Select the next to Analytics on the left pane, select DORA metrics, and then select FILTER.
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:
![Figure 2. Example Custom range selected. Custom time frame](_images/time-frame.d42c5ed.png)
To set a custom date range:
-
Select FILTER.
-
Select Custom range.
-
(Optional) Select the
to go to a previous month and year.
-
Select a date for the time frame start.
-
(Optional) Select the
to go to a subsequent month and year.
-
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:
-
Select Analytics on the left pane, and then select the dashboard.
-
Select the
on the top right of the dashboard.
-
Select Edit dashboard.
-
(Optional) Remove a chart or table from the dashboard.
-
Select the next to the chart or table you want to remove.
-
Select SAVE.
-
-
(Optional) Add back a chart or table to the dashboard.
-
Select ADD FROM LIBRARY to display a list of the available charts or tables.
-
Select ADD TO DASHBOARD next to the item you want.
-
Select APPLY.
-
-
(Optional) Rearrange the items on the dashboard.
-
Select the
on a chart or table you want to move.
-
Drag the item to a different location on the dashboard.
-
![Figure 3. Editing a dashboard, with move and remove icons highlighted. System health and runs overview](_images/customize-dashboard.5d480a3.png)
The dashboard is customized accordingly.
Only those charts and tables with a in their upper-right corner can be edited. |
Prerequisites
-
Specify the kind as
kind:deploy
in the workflow YAML for your deployment operations, as noted in Manage workflows. -
You must have at least one environment defined.
![Figure 4. Specify the environment on the job level. Example data ingestion](_images/example_data_ingestion_service_workflows.1903885.png)
Explore Deployment frequency and MTTR
![Figure 5. Explore four key Dora metrics. 4 key metrics](_images/example_DF_DLT_CFR_MTTR_charts.d5ec7b9.png)
-
Deployment frequency: The reading depicts the average number of successful deployments for the selected component and environment, per day.
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
-
-
Deployment Lead time: The reading depicts that it takes four minutes and two seconds to deploy from the time the PR is approved.
-
Change failure rate:The reading tells what percentage the deployments have failed for the selected component(s) and duration to the selected environment.
-
MTTR: The reading depicts how much time it takes for the failed deployments to resolve.
Explore Deployment frequency and Lead time trend
![Figure 7. Example Deployment frequency and Lead time trend charts. Example deploy frequency](_images/example_deployment_frequency_and_lead_time_trend_chart.0a8b217.png)
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.