Configuring Time Series

Contents:

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 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 or tables with the Rich Filter Statistics gadget. Several time series can and are generally displayed simultaneously in the same gadget, allowing users to compare and identify trends and correlations between series.

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:

Attribute

Description

Attribute

Description

Name

Each time series has a name that must be unique among the time series within the rich filter.

Color

The 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 the base for the time series. Each SLA option behaves like a date field representing the completion date of the SLA (only issues with completed SLAs 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 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 issues for which the SLA is completed

  • SLA Average – displays the average completion time for the issues that have their SLA completed

In all the cases, only the issues with the SLA completed are considered, 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 value 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 contributing to the time series. Only the issues satisfying this query will be taken into account when calculating the data points.

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:

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 the Create button.

You can add up to 80 time series in each rich filter.

View or edit a time series

Depending on your rights, click on any time series to view or edit its configuration. 

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.

Computed Time Series

Users can define unresolved time series, a special type of time series, falling under the Computed category. Unlike the other time series based on a date field, unresolved time series are computed as the difference between Created and Resolved time series. Unresolved time series allows users to monitor the size of the backlog easily.

To create an unresolved time series, start by creating one as described in Adding & Editing Time Series and then select the Unresolved option in the Series drop-down menu. The option is available under the Computed category:

The newly created unresolved time series can then be displayed in rich filter gadgets like any other time series. In the example below, the Unresolved time series is used in a rich filter time series gadget. The gadget enables users to track the trend of unresolved issues within a specific time range by monitoring the unresolved issues of each aggregation period.

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

Check the Rich Filter Time Series Chart Gadget documentation page to see how to configure the gadget.

  • Rich Filter Flexi Chart gadget

Check the Rich Filter Flexi Charts Gadget documentation page to see how to configure the gadget.

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

Check the Rich Filter Statistics Gadget documentation page to see how to configure the gadget.

  • Rich Filter Two-Dimensional Statistics gadget

Check the Rich Filter Two Dimensional Statistics Gadget documentation page to see how to configure the gadget.