This documentation relates to version 1.9 of Rich Filters for Jira Dashboards. Documentation for previous versions is available via the documentation index.

Configuring Time Series

Time series, which are part of the Advanced Settings of the Rich Filters, are collections of data points based on your issues’ date fields. For instance, the number of created issues on day 1, 2, 3 and so on, for the past month. The values for the data points may be issue counts or values computed from issue fields. 

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. Series on their own can point out trends; but, they are more powerful when plotted together. Comparing series can hint at correlations between events affecting your activity.

Key Attributes of Time Series

  • Each time series has a label and a color which are mandatory and which are used for displaying the time series in Rich Filter gadgets.
  • Each time series is based on a date field. This is is used to find the issues contributing to each data point. This setting is called Series
  • Each time series has a value which is used to compute the values of the data points. As value you can select issue count, any number field, and Σ of any number field. Σ values for an issue also include the values of its sub-tasks if any.
  • Each time series has a value type which is automatically computed based on the value setting. This can be either 'Issue Count' or 'Numeric Sum' for series based on number fields. 
  • Each time series has an optional JQL Filter which is used to apply additional filtering when computing a data point. 

Editing Time Series

  1. Navigate to the desired rich filter.
  2. Open the Time Series section.
  3. Edit the Time Series as described in the following table:
To do the following: Do this:
Create a new Time Series

Click on the Add Time Series button at the top-right of the page.  

Chose any date field as base for the Series. Insert a name, select a color, chose the value you wish to compute for the time series and optionally insert a JQL Filter in order to reduce the list of issues contributing to your series. Click the Add time series button once completed.

Edit a Time Series

Click the edit icon at the right of any time series.

A pop-up appears. Make your changes and click on the Save button.

Note that once the time series is created, there are two settings that cannot be changed anymore:

  • the Series date field;
  • the Value Type: this means that if you have selected Issue Count as the value, you cannot change it. If you had selected, for example, a number field as the value, then the value type would be Numeric Sum. You could then update the Value and select another number field, but you could nod choose Issue Count anymore (the value type would have to remain Numeric Sum).

This is necessary in order to ensure the consistency of time series once used in the Rich Filter Time Series Chart gadgets. In a Time Series Chart gadget we can display together only series having compatible value types (i.e. we can display together either series based on multiple Issue Count or on Numeric Sum values but not combinations of these).

In order to change these two settings you need to create a new time series.

Delete a Time Series

Click the delete icon at the right of any time series.

Reorder the Time Series list

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

This order is used to display the time series in the settings of Rich Filter Time Series Chart and Rich Filter Statistics gadgets.

Have a look at The Rich Filter Time Series Chart Gadget and The Rich Filter Statistics Gadget documentation pages in order to see how to display the time series in dashboards.