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

Configuring Time Series

In this section:

  1. About Time Series
  2. Adding New Time Series & Time Series' Key Attributes
  3. 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 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.

2. Adding New Time Series & Time Series' Key Attributes

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

In order to define new time series, click on the Add time series button at the top-right of the page. The Add a time series dialog will be displayed.

The key attributes of a time series are:

AttributeDescription
SeriesEach time series is based on a date field. This is is used to find the issues contributing to each data point.
LabelThe label is mandatory and it is used to identify and display the time series in rich filter gadgets.
ColorThe color is used to display the time series in rich filter gadgets.

Value

Each time series has a value which is used to compute the values of the data points. As value you can select issue count or any number field or custom values.

Value Type
Displayed in the table listing all the Time Series

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

  • Issue Count – for values based on the number of issues
  • Numeric – for values based on numeric fields
  • Duration – for custom values based on duration values (see the Configuring Custom Values section)
JQL FilterAn optional JQL filter can be used to apply additional filtering when computing a data point. Only the issues that satisfy the additional JQL filter contribute to the results.

Rich Filter Extensions

Rich filter extensions are separate Jira apps that can be installed on top of the Rich Filters for Jira Dashboards app to extend the rich filters and rich filter gadgets with new specific functionality.

New time series options are available if you add any of the these extensions:

3. Editing Time Series

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

To do the following:Do this:
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.

4. Using Time Series in Rich Filter Gadgets

Once defined, the time series can be displayed by two rich filter gadgets:

  • The 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 to display time series. 

  • The 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 to display time series.