Control Chart

Still need help?

The Atlassian Community is here for you.

Ask the community

The Control Chart shows the cycle time and lead time for your product, version, or sprint. It takes the time spent by each issue in a particular status and maps it over a specified period of time. The chart also shows the average, rolling average, and standard deviation for this data.

A Control Chart helps you identify whether data from the current sprint can be used to determine future performance. The less variance in the cycle time of an issue, the higher the confidence in using the mean (or median) as an indication of future performance.

Here are some of the ways that you could use a Control Chart:

  • analyze your team's past performance in a retrospective
  • measure the effect of a process change on your team's productivity
  • provide external stakeholders with visibility of your team's performance
  • for Kanban, use past performance to set targets for your team

On this page:

Control Chart

  1. Issue details: See the cycle time for an issue.
  2. Time scale: Select a time period to display on the control chart.
  3. Zoom in: Highlight an area of the chart to focus on a specific time period.  
  4. Refine report: Select the columns and filters you want data for.

Viewing the Control Chart

  1. Navigate to your desired board.
  2. Click Reports, then select Control Chart.
  3. Configure the chart as desired. The screenshot at the top of this page highlights the controls that you can use to configure the Control Chart.

Tip: Click How to read this chart at the top of the report to view a short description of the report. 

If you're using Internet Explorer 8, the Control Chart won't work.

Printing the Control Chart

To print the report, view the report and use the print functionality for your browser. The report will fit on either A4- or Letter-sized pages in both portrait and landscape modes (note, there is a known issue printing in landscape using Chrome).

Understanding the Control Chart

Before you start using the Control Chart, you should learn how it works. The following questions and answers cover the key functionalities of the Control Chart

What is cycle time and lead time?

Cycle time is the time spent working on an issue. Typically, it's the time from when the work on an issue begins to when this work is completed. It also includes any other time spent working on the issue. For example, if an issue is reopened, worked on, and completed again, the time for this extra work is added to the cycle time.

Lead time is similar to cycle time but is the time from when an issue is logged (not when work begins) until the work is completed.

How is cycle time calculated?

Cycle time

The statuses for calculating cycle time depend on the workflow you're using for your project. You should configure the Control Chart to include the statuses that represent the time spent working on an issue. Note that the Control Chart will select these statuses automatically.

For example, if you're using the Jira Software Development workflow, the work on an issue may start when its status changes to In progress and finish when the issue transitions from In review to Done.

You can set this on the Control Chart by selecting In Progress and In Review as the columns so that you’ll see the time that issues have spent in these two statuses.

The average cycle time is calculated by adding the time that each issue has spent in each of the selected statuses and dividing the total by the number of issues.

For example, you have five issues that have spent the following amount of time in the statuses In Progress and In Review.

IssueIn ProgressIn Review
ISSUE-11 day1 day
ISSUE-22 days2 days
ISSUE-33 days1 day
ISSUE-41 day3 days
ISSUE-52 days3 days

The average cycle time is (1+1+2+2+3+1+1+3+2+3)/5 = 3.8 days.

How is lead time calculated?

You can also configure the Control Chart to show lead time instead of cycle time.

Just like for cycle time, the statuses for calculating lead time depend on the workflow you're using for your project. For example, if you're using the Jira Software Development workflow, an issue gets raised when it acquires the status To Do and gets completed when it transitions from In Review to Done.

You should configure the Control Chart to include the statuses that represent the time from when an issue was raised until when it was done. Note that the Control Chart will select these statuses automatically.

To set this on the Control Chart, select To Do and In Review as the columns so that you’ll see the time that issues have spent from when they were raised to when they were completed.

The average lead time is calculated by adding the time that each issue has spent in each of the selected statuses and dividing the total by the number of issues.

For example, you have five issues that have spent the following amount of time in the statuses To Do, In Progress, and In Review.

IssueTo DoIn ProgressIn Review
ISSUE-12 days1 day1 day
ISSUE-21 day2 days2 days
ISSUE-32 days3 days1 day
ISSUE-44 days1 day3 days
ISSUE-53 days2 days3 days

The average cycle time is (2+1+1+1+2+2+3+3+1+4+1+3+3+2+3)/5 = 6.4 days.

How is rolling average calculated?

The rolling average (blue line on the chart) is issue-based, not time-based. For every issue shown on the chart, the rolling average (at that point in time) is calculated by taking the issue itself, X issues before the issue and X issues after the issue, then averaging their cycle times. 20% of the total issues displayed (always an odd number and a minimum of 5 issues) is used in the calculation.

For example, in the screenshot below, at the point of time where an issue (green dot) is shown, the rolling average is calculated as follows:

  1. Take the issue plus four issues before and four issues after (nine issues total).
  2. Average the cycle times for the nine issues.
  3. Map the blue line to the calculated average.

If the Timeframe is reduced to 'Past two weeks', the number of issues used would reduce, as there are fewer total issues available to use for the calculations.

This method produces a steady rolling average line that shows outliers better (i.e. rolling average doesn't deviate as sharply towards outliers). The rolling average line is also easy to understand, as the inflections are related to the positions of issues.

(info) If you would like to know more about why the rolling average calculation is based on a percentage of the total issues, rather than a time period, see Comparing different methods of calculating the rolling average on the Control Chart.

What does the blue shaded area represent?

The blue shaded area of the control chart represents the standard deviation that is, the amount of variation of the actual data from the rolling average.

The standard deviation gives you an indication of the level of confidence that you can have in the data. For example, if there is a narrow blue band (low standard deviation), you can be confident that the cycle time of future issues will be close to the rolling average.

What do the dots on the chart represent?

As shown on the chart legend, each dot represents an issue or a group (cluster) of issues:

  • The vertical placement of the dot represents the cycle time for the issue, i.e. the 'Elapsed Time'. For a cluster of issues, the dot is placed at the average cycle time for the issues.
  • The horizontal placement indicates when the issue(s) transitioned out of the last status selected on the chart (in Columns). For example, if you are using the 'Jira Software Development' workflow and have selected 'In Progress' and 'In Review' as the columns on the Control Chart, the dots will indicate when the issue transitioned out of the 'In Review' status.
Why does the scale of the Elapsed Time axis change when I change Timeframe?

If the maximum Elapsed Time value on the chart is less than 30 days, then a linear scale is used for the y-axis. If it is 30 days or greater, than a cube-root power scale is used.

When you change the Timeframe, you may include issues with an elapsed time of greater than 30 days when you previously did not, or vice versa. This will change the scale, as described above.

Linear scale for Elapsed Time

Cube-root power scale for Elapsed Time

Tips and examples

Learn how to tweak your Control Chart to show the data you need with the following examples:

Show me some tips...

Tip 1: Remove unwanted outliers

The Control Chart can help you identify outliers. On closer examination, you may determine that certain outliers are invalid due to human error. For example, you may have a story that was started but stopped, then eventually dropped back to the backlog, but not returned to the 'To Do' status. The time that the issue spent 'In Progress' would incorrectly skew the data for your Control Chart. 

To remove unwanted outliers from your Control Chart, add a label to each outlier issue (e.g. outlier) and create a Quick Filter with this JQL: labels is EMPTY or labels not in (outlier). Configure your Control Chart to use this Quick Filter.

Example Control Chart with invalid outliers

Example Control Chart with invalid outliers removed (note the smaller scale for 'Elapsed Time')

Tip 2: Remove triage casualties

In a Control Chart, you generally want to track the issues that are resolved as 'Fixed'. Issues that are triaged and resolved as a duplicate, answered, tracked elsewhere, etc can skew the data, bringing the average cycle time down considerably.

To remove triage casualties from your Control Chart, create a Quick Filter with this JQL: resolution in (Fixed). Configure your Control Chart to use this Quick Filter.

Example Control Chart including issues where the resolution is not 'Fixed'

Example Control Chart excluding issues where the resolution is not 'Fixed' (note the higher average cycle time)

Tip 3: Exclude current work

The Control Chart shows data for issues that have been in a selected column, but are no longer in a selected column. This gives the cycle time (total elapsed time) for the issues. However, by default, this will include issues that are still moving across the board.

To view the data for completed work only in your Control Chart, create a Quick Filter with this JQL: status in (Resolved, Closed). Configure your Control Chart to use this Quick Filter.

Example Control Chart including all issues

Example Control Chart including issues where the status is 'Resolved' or 'Closed' only

Learn how to interpret a Control Chart with the following examples:

Show me some examples...

Example 1:


  • The productivity of the team is increasing: indicated by the downward trend of the rolling average.
  • The cycle time of future issues are likely to be close to the rolling average (2 days or less): indicated by the low standard deviation (narrow blue shaded area).

Example 2:

  • The team's productivity is pretty consistent: indicated by rolling average being close to the average.
  • There are obvious outliers on Tue 14 and Wed 15 (7 days and 10 days elapsed time respectively, compared 2 days on average) that should be investigated. 
  • Data is becoming more predictable over time.

Known issues

If you encounter an issue that is not on this list, please raise it in our issue tracker.

Click to view known issues...

  JSWSERVER-16449 - Getting issue details... STATUS

JSWSERVER-20516 - Getting issue details... STATUS

JSWSERVER-16393 - Getting issue details... STATUS

JSWSERVER-21120 - Getting issue details... STATUS

JSWSERVER-12122 - Getting issue details... STATUS

JSWSERVER-21491 - Getting issue details... STATUS

Next steps

Need help? If you can't find the answer you're looking for in our documentation, we have other resources available to help you. Check out Getting help

Read the following related topics:

Last modified on Dec 13, 2023

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.