Cumulative flow diagrams

Overview

A Cumulative Flow Diagram tracks progress over time on a scope of work as issues move through project workflows. This simple chart provides a wealth of information about program health, the effect of scope changes, process bottlenecks, and team throughput.

Here you'll see how to easily create a Cumulative Flow Diagram across one or many projects, and then break down those results by any combination of Jira fields such as Issue Type, Component, Assignee, or Project.

Creating the report

Select the /wiki/spaces/dataplaneDraft/pages/442728521.

For report configuration options, set up your report as follows:

Option	Selection	Comments

Option	Selection	Comments
Time period	any	Select your dates of interest using relative dates ("Last 3 Months", "This Year") or a custom Start Date and End Date.
Search	any	Select your Jira projects, project categories, and filters of interest. Or click the JQL tab in that field to enter a command using Jira Query Language (JQL).
Statuses to include	all	Select which Jira issue statuses you want to include in the report. Select all statuses in your Jira instance for a complete picture of scope, scope changes, and completed issues.
Value of	Status (Historical)	We're reporting on issues based on what their status was during each historical reporting interval.
Chart type		Select the Area Chart.

Click the Run Report button to create your report.

Your results will look something like this:

Segmenting results

The Segment By field in Dataplane reports lets you break down report results by any number of different Jira fields or properties to see more granularity.

For example, when looking at a Cumulative Flow Diagram for a program of multiple projects, select Project for Segment By to see each project's contribution to the results. Or select Issue Type, Assignee, or any combination of the above for even more detailed analysis.

In the following report, we've segmented the results by Project:

In this example, we've instead segmented the report by both Issue Type and Priority:

Reporting based on sprints

You can hone in on just those issues that were within specific sprints during the selected time period with some JQL.

For the Search field on the report configuration page, click the JQL tab and enter a custom query like:

project in ("Project A", "Project B") and sprint in (39, 40, 41, 42, 43)

Customizing chart colors

In the above charts, you can see that as we add additional levels of data segmentation, we can do more detailed, granular analysis. However, with lots of series charted at once, there can also be a lot of visual noise.

A good way to improve our ability to analyze report results with many charted series is to use a Dataplane /wiki/spaces/dataplaneDraft/pages/442728999 to choose custom colors for the chart.

To access the Customizer Script field, go to the report configuration tab in your report and click the More Options link.

Then copy and paste the following script into the Customizer Script field as a starting point. Add additional lines or modify this script based on the specific Status options in your Jira instance.

customizeChart {
    series "Open" colorLike "aqua"
    series "Reopened" colorLike "blue"
    series "Closed" color "gainsboro"
    series "Waiting" colorLike "orange"
}

In this script, we color similar charted series (for example, any segmented series that starts with Open) with similar colors to reduce the overall visual noise.

Here's what our chart now looks like with customized colors:

The value of using a Customizer Script to customize series colors is even more apparent in the following example, where the report results are segmented into well over a dozen separate series. Custom colors allow easy reading of the primary status changes in this Cumulative Flow Diagram without giving up the ability to do more granular data analysis.

Page Contents