This page relates to the Cloud version of Rich Filters for Jira Dashboards. Please see the documentation index for Server & Data Center versions.

Configuring Time Series

In this section:

  1. About Time Series
  2. Time Series' Key Attributes
  3. Adding & Editing Time Series
  4. Using Time Series in Rich Filter Gadgets

1. About Time Series

Time series are collections of data points based on your issues’ date fields – for example the number of issues due for each week of the current quarter, or the monthly SLA %Met ratio of the last year. The data points can be based on issue counts or on values computed from issue fields. JQL filters can optionally be used to limit series to subsets of issues.

The time series can be displayed as line charts with the Rich Filter Time Series Chart gadget, or as tables with the Rich Filter Statistics gadget. Several time series can and are generally displayed simultaneously in the same gadget, allowing users to make comparisons and identify trends and correlations between series.

2. Time Series' Key Attributes

You can add new and see existing time series and their configuration in the Time Series section of your rich filter.

The key attributes of a time series are:

AttributeDescription
NameEach time series has a name which must be unique among the time series within the rich filter.
ColorThe selected color will be used to display the series in some of the rich filter gadgets.
Series

Each time series is based on a date field, which is used to identify the issues contributing to each data point.

SLA Time Series

The user can also select any SLA field as base for the time series. Each SLA option behaves like a date field representing the completion date of the SLA (only issues which have their SLA completed are taken into account; the completion date of the last SLA cycle is used).

Base value

The value on which the data points are based. This can be Issue Count, numeric and time-tracking fields, SLA values (see below), custom values, or custom ratios

SLA Time Series

If the series are based on an SLA fields, then the following SLA values become available:

  • SLA Completed – returns the issues for which the SLA is completed
  • SLA Met – returns the issues for which the SLA is completed and met
  • SLA Breached – return the issues for which the SLA is completed and breached
  • SLA %Met – return the percentage of issues for which the SLA is met out of the issue for which the SLA is completed
  • SLA %Breached – returns the percentage of issues for which the SLA is breached out of the issue for which the SLA is completed
  • SLA Average – displays the average completion time for the issues which have their SLA completed

In all the cases, only the issues with the SLA completed are taken into account and only the last cycle is included in any computation.

Value type

Displayed in the time series table

The value type is automatically computed based on the base value. The possible values types are: 

  • Issue Count – for series based on the number of issues, directly (Issue Count) or through custom values
  • Numeric – for series based on numeric fields, directly or through custom values
  • Time Tracking – for series based on time tracking fields, directly or through custom values
  • SLA Average – for series based on SLA averages
  • Ratio – for series based on SLA ratios or on custom ratios

The value type is pertinent in the Rich Filter Time Series Chart gadget, where the time series plotted together on the same chart must have the same value type.

JQL

You can optionally define a JQL query to filter the issues which contribute to the time series. Only the issues which satisfy this query will be taken into account when calculating the data points.

3. Adding & Editing Time Series

The Time Series section of your rich filter allows you to perform the following operations:

To achieve this:Do the following:
Add a new time series

Click on the Create time series button at the top-right of the page.

Type a name, select a color, a series and a base value and optionally type a JQL query, then click on the Create button.

View or edit a time series

Click on any time series to view or edit its configuration, depending on your rights. 

Reorder the time series

Hover over the vertical “grid” icon, then drag and drop the time series up or down to the new position.

Delete a time series

Click on the delete icon located at the right of the time series.

4. Using Time Series in Rich Filter Gadgets

Below we provide the list of rich filter gadgets that can display time series:

  • Rich Filter Time Series Chart gadget – it displays the time series as line charts

Have a look at The Rich Filter Time Series Chart Gadget documentation page to see how to configure the gadget.

  • Rich Filter Statistics gadget – it displays the time series in table format

Have a look at The Rich Filter Statistics Gadget documentation page to see how to configure the gadget.