What is the Controls Feature?
Controls lets you choose how supported report metrics are calculated and how their charts are displayed. Open the sidebar using the adjustments button on the right of the Controls bar, below the dashboard filters.
The available sections depend on the report and selected card. A card without supported options does not show the Controls panel. The sidebar's help link opens this guide.
Key Features
Statistical Measure
When Statistical Measure is available, choose:
- Average: the arithmetic average of the values.
- Mode: the most frequently occurring value.
- Percentile: a value at a selected position in the data distribution. Choose 30th Percentile, Median (50th Percentile), 70th Percentile, 85th Percentile, or 95th Percentile under Statistical Percentiles.
For example, the 85th percentile helps you examine the duration within which approximately 85% of observations fall. Selecting Percentile initially selects the median; choose another percentile if needed.
Chart Settings
Where Chart Settings is available, enable Trendline for a straight line fitted with linear regression, or Regression line for a curve fitted with polynomial regression. These overlays help you inspect patterns in the displayed data; they are not forecasts.
Reports that offer only Chart Settings do not offer Average, Mode, or Percentile in Controls. Their chart options do not change how the underlying metric is calculated.
PR Cycle Time Stages
For PR Cycle Time metrics, PR Cycle Time Stages lets you include or exclude Coding, Pickup, Review, Merge, and Deploy from the total. Keep at least two stages selected.
With Mode, all five stages are used and stage selection is disabled. With Average or Percentile, you can customize the selection. Saving a changed stage selection returns the selected card to the overall PR Cycle Time metric.
These options are also available when the PR Cycle Time card is selected in Speed or DORA.
Available Reports and Options
Controls is available across the following 15 dashboards. Options apply to the selected metric; they are not identical across every card in a report.
| Report | Available Controls |
|---|---|
| PR Cycle Time | Statistical Measure, Chart Settings, and PR Cycle Time Stages. |
| Issue Cycle Time | Statistical Measure and Chart Settings. |
| Speed | PR Cycle Time: all three sections. Issue Cycle Time: Statistical Measure and Chart Settings. Deploys Frequency in Days: Statistical Measure only. |
| DORA | PR Cycle Time: all three sections. Mean Time to Recovery and Deploys Frequency in Days: Statistical Measure only. Change Failure Rate: no Controls. |
| Deploy | Deploys Frequency in Days: Statistical Measure only. Deploy count and Change Failure Rate: no Controls. |
| Code Review | PR size, Review depth, and Comments per review: Statistical Measure only. Other cards: no Controls. |
| Work Breakdown | Code Changes, New Code, Refactor, and Rework: Statistical Measure only. |
| Planning Accuracy | Statistical Measure and Chart Settings. |
| Throughput | Chart Settings only. |
| Productivity | Chart Settings only. |
| Collaboration | Chart Settings only. |
| Daily WIP | Chart Settings only. |
| Investment Profile | Chart Settings only. |
| Engineering Investment | Chart Settings only. |
| Code Quality | Chart Settings only. |
In Speed, DORA, Code Review, Work Breakdown, and Deploy, select the card you want to analyze before opening Controls. For example, DORA's Change Failure Rate card does not show Controls, while its PR Cycle Time card offers all three sections.
How to Use Controls
- Open a report and select the relevant card, if the dashboard has selectable cards.
- Click the adjustments button on the right of the Controls bar.
- Set the available Statistical Measure, Chart Settings, or PR Cycle Time Stages options.
- Click Save to apply the changes and close the sidebar.
Saved preferences are reused across supported metrics. Each metric applies only the Controls options it supports.