Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

If you are involved in a company service management function, you will know that reporting is critical for your team's success. Your leadership will want regular reports to show that you are meeting meet company objectives with respect to for SLAs and customer satisfaction levels. They will want like this information in an easily - digestible format, allowing them to break the data down by different teams or service desks and look at trends over time. They want to see where the successes are , but also easily quickly find problematic trends that allow preemptive responses to potential failures.

This article shows you how to create a powerful support request reporting dashboard with Rich Filters for Jira Dashboards that fulfills the needs described above, allowing . It allows you to report progress against targets , and monitor your work for success and problem patterns. This is a key part of delivering an effective ITSM strategy.

Contents:

Table of Contents
minLevel1
maxLevel6
outlinefalse
stylenone
typelist
printabletrue

Prerequisites

This article assumes that you are using Jira Service Management.

...

Imagine the following scenario (your exact situation might have different numbers of projects or teams , or other constraints, but the principles are the same):

  • You have three different service management projects to support three different products.

  • To answer support requests, you have support agents grouped into two teams that provide coverage for different geographical regions.

  • The support agents in each team

    have specialized knowledge of

    specialize in different products, with the aim of providing good overall coverage across all of them.

  • You want to create an efficient way of reporting on Time to first response / Time to resolution SLAs and customer satisfaction

    ,

    that can show trends over time and progress across multiple projects by team, customer, customer request type, individual assignee, etc.

How can you provide this level of reporting in an easy-to-digest format, all in one place?

...

Rich Filters for Jira Dashboards provides a perfect feature set for reporting on your support request progress, which you'll see in action through the article. Rich filters are based on a standard Jira filter, hence the issues listed in rich filter gadgets can be cross-project. This enables you to build a single dashboard to report on multiple service management projects, giving rich filters a definite advantage over Jira's built-in Service Management reporting, which is defined for single projects.

To provide a solution to satisfy the use case detailed above, we are going to show you how to create the following dashboard:Dashboard showing a controller, simple gauges, one and two dimensional statistics, flexi chart, and time series chartImage Removed

...

First of all, however, we'll explore how this dashboard works and how it can facilitate effective, powerful reporting across all your projects, customers, and teams. Later on, we'll walk you through how to build it.

...

On the left-hand side of the dashboard, we've got a set of gauges that provides a top-level view of where we are in terms of meeting our SLAs. Here we are showing % of met for both time to first response (TTFR) and time to resolution (TTR) SLAs:Image Removed

...

This is a good place to talk about the quick filters inside the Rich Filter Controller. We can use these controls to filter the data shown in all the other rich filter gadgets, meaning that we can dynamically create more specific data breakdowns whenever needed. For example, we can filter by Blue Team and Fox Service Desk:Rich Filter controller gadget with active filters for Fox Service Desk project and Blue TeamImage Removed

...

Our gauges will now show % of met for our SLAs, only for Blue Team working on the Fox Service Desk project:Image Removed

...

Break down SLA targets by team and project

If you want some permanent views of specific data breakdowns that you find important, you can create these using rich filter statistics gadgets. In our Our reporting dashboard we've got has three main breakdowns.

First of all, we show the issue count, TTR % breached, and customer satisfaction for each of our teams:Rich Filter Statistics gadget showing issue count, TTR percentage breached, and satisfaction for each teamImage Removed

...

We can also show a two-dimensional breakdown — in breakdown—in the next statistic gadget, ; we show the TTFR % met for each combination of team and customer request type, so we can see how each team is performing on in each type kind of request , and see where potential weaknesses are. The customer request types are ordered, ascending from lowest performance to highest.Image Removed

...

Finally, we show a two-dimensional breakdown of the TTR % breached for each combination of organization and service management project combination.Image Removed

...

Tip

You can create data breakdowns of data based on whatever statistics you wish, and you can also filter any of them using the quick filters in your controller.

Generating quick charts

You can dynamically create a quick chart to summarize the data in any statistics gadget by clicking the Switch to quick chart view button in the bottom-right-hand-corner:Rich Filter Statistics gadget with Switch to quick chart view button highlightedImage Removed

...

Clicking the button displays a chart that summarizes summarizing the data in the statistics table. For example:
Image Removed

...

Tip

Note that chart gadgets (e.g., Rich Filter Flexi Charts, Rich Filter Time Series Chart) have a Show table button in the bottom-right-hand corner that allow you to generate quick tables from charts.

Show historical progress against targets.

Our last category of gadgets in this dashboard provides breakdowns and views of historical data from various time series — a powerful way to check on trends and progress.

First of all, we've got another statistics gadget showing columns for a number of several useful statistic types : number of created issues, TTFR % met, TTFR average, TTR % met, TTR average, and customer satisfaction. In each row, we We show historic monthly totals for each statistic type in each row, with the most recent month at the top.Rich Filter Statistics gadget showing created, TTFR, TTR, and Satisfaction, all by monthImage Removed

...

We can also provide charts to summarize our data. In a flexi chart gadget, we show the TTR % met by the team and TTR over historic weeks.Image Removed

...

Finally, we use a dedicated time series chart to show the historic weekly trends for the TTFR average and TTR average in hours.Rich Filter Time Series chart showing TTFR average and TTR average over historic weeksImage Removed

...

Rich filter features resources.

The following links provide information on the fundamentals of each rich filter feature used in this dashboard , in case you need more information:

Start building the Support request reporting dashboard

Now that we've explained what our solution can do , let's go ahead and build it.

In this section, you'll create a new rich filter and a dashboard with minimal configuration to begin with. If you need any instruction instructions on creating rich filters and dashboard basics, you can find it them in Get started Started with Rich Filters for Jira Dashboards.

  1. Create a new rich filter based on a Jira filter that returns all the support request issues you want to report on with your dashboard (see Get started with Rich Filters for Jira Dashboards for guidance if needed). Call it something appropriate like "Support request reporting". Remember that your Jira filter can return support request issues from multiple Service Management projects, therefore this solution has the advantage that it is cross-project.

  2. Create a new dashboard with the Left sidebar layout, called something appropriate like "Support request reporting dashboard".

  3. Add a Rich Filter Controller gadget to your dashboard.

  4. Select your Support request reporting rich filter as the Rich filter value, then click Submit:

  5. Press the Done button at the top of the UI to exit dashboard edit mode.

You should now have a basic dashboard that contains a single Rich Filter Controller gadget:Starting state of the Rich Filter controller gadget - no quick filters, just a field to manually enter a JQL filterImage Removed

...

Important time-saving tips:

  1. When you need to further configure an existing gadget, don't do it via dashboard edit

...

  1. mode—you can do it more quickly and with fewer dashboard refreshes using the

...

  1. rich filter menu available on each rich filter gadget.

  2. The Rich filter menu also contains an option to open the config for the rich filter the gadget is based on. For convenience, we recommend

...

  1. keeping the dashboard open in one browser tab, keeping the rich filter

...

  1. configuration open in another tab, and

...

  1. moving between the two as

...

  1. needed.

  2. When you've

...

  1. changed the rich filter config in one tab and want to see those changes reflected in the dashboard in the other tab, refresh your dashboard quickly and conveniently using your controller's Optimized refresh button.

Set up your filters

In this section, you will create all the quick filters you'll use in your dashboard. The static and dynamic filters will be usable from your controller and provide a lot of power — they filter the content shown in all other rich filter gadgets based on the same rich filter as the controller (for more information on static and dynamic filters, have a look at Get started with Rich Filters for Jira Dashboards and Enhance your Jira dashboards with dynamic filters).

  1. Go to the Static Filters tab of your rich filter config (accessed via the Rich filter menu) and create a new static filter called "Assigned to me", with the JQL "assignee = currentUser()".

  2. Go to the Dynamic Filters tab and add dynamic filters based on the

...

  1. Jira fields — Created, Priority, Customer Request Type, Organizations, Assignee, Issue Type, and Project.

In our scenario, we have two support teams. Let's create a "Team" smart filter to allow you to display a quick filter in your controller to filter by team (for more information on configuring and using smart filters, see our Use custom smart filters and smart columns on your dashboardarticle).

  1. Go to the Smart Filters tab.

  2. Create a new smart filter called "Team".

...

  1. Create a separate smart clause for each team in the Team config screen. We've included two, but you might want to include more:

    1. "Blue Team": Give it a blue color and JQL to filter by members of that team, for example "assignee in membersOf("blue-team")".

    2. "Orange Team": Give it an orange color and JQL to filter by members of that team, for example, "assignee in membersOf("orange-team")"

Tip

As an alternative to the above JQL, you might instead want to filter each team's JIRA issues using JQL like "assignee in (a,b,c)", where the letters are different assignee IDs.

Go back to your dashboard and refresh it; your controller should look like this:Rich filter controller with assigned to me, created, priority, customer request type, organizations, assignee, issue type, project, and team filters. None are active.Image Removed

...

Set up your time series

In this section, you'll create some custom time series that you can then use in your gadgets to easily display trends over time as desired (see Configuring Time Series for more information).

  1. Go to the Time Series tab

...

  1. in your rich filter

...

  1. configuration.

  2. Create a new time series called "Created", with a custom pink color.

  3. Choose the Created field

...

  1. to show the Series

...

  1. .

  2. Choose Issue Count for the Base value. This

...

  1. series will provide an issue count for created issues over time.

  2. Click Create.

Repeat the process to create five more time series; choose a custom color for each one:

  1. "Satisfaction": Show customer satisfaction for resolved issues over time.

    1. Color: yellow.

    2. Series: Resolved.

    3. Base value: Satisfaction.

  2. "TTFR - Avg": Show average TTFR over time.

    1. Color: mid blue.

    2. Series: Time to first response (completion date).

    3. Base value: Time to first response - Average.

  3. "TTR - Avg": Show average TTR over time.

    1. Color: sky blue.

    2. Series: Time to resolution (completion date).

    3. Base value: Time to resolution - Average.

  4. "Time to first response - % Met": Show TTFR met/total over time.

    1. Color: green.

    2. Series: Time to first response (completion date).

    3. Base value: Time to first response - % Met.

  5. "Time to resolution - % Met": Show TTR met/total over time.

    1. Color: green.

    2. Series: Time to resolution (completion date).

    3. Base value: Time to resolution - % Met.

Your Time Series tab should now look like this:Image Removed

...

Set up the Rich Filter Simple Gauges gadget

Let's get your dashboard set up! You'll start by adding the Rich Filter Simple Gauges gadget (for more information on gauges, see our Use rich filter counters and gauges in your dashboards article).

  1. Go to dashboard edit mode and add a Rich Filter Simple Gauges gadget to your dashboard.

  2. Position it below your controller in the left-hand column.

  3. In the gadget config form,

...

  1. select your Support request reporting rich filter in the Rich filter dropdown.

  2. Add the following SLA ratios to the Gauge filters and values list by choosing them from the Pick a filter

...

  1. dropdown.

    1. Time to first response - % Met

    2. Time to resolution - % Met

  2. Click Submit.

Your Rich Filter Simple Gauges gadget will now look like this:Image Removed

...

Set up the first Rich Filter Statistics gadget

Next, you'll add a Rich Filter Statistics gadget, which provides a simple breakdown of issue count, TTR % breached, and customer satisfaction , by team (for further information on one- and two-dimensional statistics, see Display statistics and quick charts on your dashboard).

  1. Go to dashboard edit mode and add

...

  1. a Rich Filter Statistics gadget to your dashboard.

  2. Position it below your Rich Filter Simple Gauges gadget in the left-hand column.

  3. In the gadget config form,

...

  1. select your Support request reporting rich filter in the Rich filter dropdown.

  2. In Breakdown by > Statistic type, select your Team smart filter.

  3. Choose the following Values in the Pick a value

...

  1. dropdown:

    1. Issue Count

    2. Time to resolution - % Breached

    3. Satisfaction

  2. Click Submit.

Your left-hand Rich Filter Statistics gadget should look like this:Image Removed

...

Set up the first Rich Filter Two Dimensional Statistics gadget

Now, you'll add a Rich Filter Two-Dimensional Statistics gadget, which will provide a breakdown of TTFR (met) by team and customer request type.

  1. Go to dashboard edit mode and add

...

  1. a Rich Filter Two-Dimensional Statistics gadget to your dashboard.

  2. Position it below

...

  1. your Rich Filter Statistics gadget in the left-hand column.

  2. In the gadget config form,

...

  1. select your Support request reporting rich filter in the Rich filter dropdown.

  2. In Horizontal breakdown > Statistic type, select your Team smart filter.

  3. In Vertical breakdown > Statistic type, select Customer Request Type.

  4. In Vertical breakdown > Sort by, select Total.

  5. Check the Vertical breakdown > Reverse sort order checkbox

...

  1. to see the customer request types with the worst performance (lowest totals) at the top of the list.

  2. In the Value dropdown, select Time to first response - % Met.

  3. Click Submit.

Your left-hand Rich Filter Two-Dimensional Statistics gadget should look like this:Image Removed

...

Set up the second Rich Filter Two Dimensional Statistics gadget

To show a provide useful bit of variety in reporting, you will now add another Rich Filter Two Dimensional Statistics gadget. This gadget will provide a breakdown of TTR % breached by organization and project.

  1. Go to dashboard edit mode and add another Rich Filter Two-Dimensional Statistics gadget to your dashboard.

  2. Position it at the top of the right-hand column.

  3. In the gadget config form,

...

  1. select your Support request reporting rich filter in the Rich filter dropdown.

  2. In Horizontal breakdown > Statistic type, select Organizations.

  3. Check the Horizontal breakdown > Filter out None checkbox

...

  1. . In this case, it is not useful to see information on issues

...

  1. irrelevant to any organization.

  2. In Vertical breakdown > Statistic type, select Project.

  3. In the Value dropdown, select Time to resolution - % Breached.

  4. Click Submit.

Your right-hand Rich Filter Two-Dimensional Statistics gadget should look like this:Image Removed

...

Set up the second Rich Filter Statistics gadget

Your next gadget will be another Rich Filter Statistics gadget. With this, you'll start to see how powerful rich filters can be for showing trends over time: let's play with some time series. This gadget will provide a breakdown over time of created issues, TTFR % met, average TTFR, TTR % met, average TTR, and customer satisfaction — all by month.

  1. Go to dashboard edit mode and add another Rich Filter Statistics gadget to your dashboard.

  2. Position it in the right-hand column

...

  1. below the Rich Filter Two-Dimensional Statistics gadget.

  2. In the gadget config form,

...

  1. select your Support request reporting rich filter in the Rich filter dropdown.

  2. In Breakdown by > Statistic type, select Time series. This means

...

  1. you'll

...

  1. choose a time series to display trends over time in this gadget.

...

  1. Select Months for Aggregation periods

...

  1. — we want to show a data breakdown by each

...

  1. month.

  2. In the fields below, select Time range: Number of months, Number: 6, Direction: Past. We want to show totals for each of the last

...

  1. six months.

  2. Check the Reverse sort order checkbox

...

  1. so that

...

  1. the most recent month appears at the top of the list.

  2. Choose the following Time series in the Pick a time series... dropdown:

    1. Created

    2. Time to first response - % Met

    3. TTFR - Avg

    4. Time to resolution - % Met

    5. TTR - Avg

    6. Satisfaction

  3. Click Submit.

Your right-hand Rich Filter Statistics gadget should look like this:Image Removed

...

Set up the Rich Filter Flexi Charts gadget

Now, you'll add a Rich Filter Flexi Charts gadget; you'll use this to create a clustered bar graph showing the percentage of issues that had the TTR met over a historical series of weeks for each team. If you need more guidance on setting up flexi charts, have a look at Display custom charts and quick tables on your dashboard.

  1. Go to dashboard edit mode and add a Rich Filter Flexi Charts gadget to your dashboard.

  2. Position it in the right-hand column

...

  1. below the Rich Filter Statistics gadget.

  2. In the gadget config form,

...

  1. select your Support request reporting rich filter in the Rich filter dropdown.

  2. For the Chart type, choose the Clustered bar.

  3. In Primary Breakdown > Statistic type, select Time to resolution (completion date).

  4. For Aggregation periods, select Weeks.

  5. In the fields below, select Time range: Between dates, then

...

  1. choose From and To dates that

...

  1. encapsulate your data range nicely.

  2. In Secondary Breakdown > Statistic type, select Team.

  3. For Value,

...

  1. choose Time to resolution - % Met.

  2. Click Submit.

Your Rich Filter Flexi Charts gadget should look like this:Image Removed

...

Set up the Rich Filter Time Series Chart gadget

Finally, you'll add a Rich Filter Time Series Chart gadget. This will show a handy line graph of the historical average TTFR and TTR trends (for more information on configuring time series gadgets, see The Rich Filter Time Series Chart Gadget).

  1. Go to dashboard edit mode and add a Rich Filter Time Series Charts gadget to your dashboard.

  2. Position it in the right-hand column

...

  1. below the Rich Filter Flexi Charts gadget.

  2. In the gadget config form,

...

  1. select your Support request reporting rich filter in the Rich filter dropdown.

  2. For Aggregation periods, select Weeks.

  3. In the fields below, select the Time range

...

  1. , Number of weeks, Number

...

  1. 12, and Direction

...

  1. , Past.

  2. For Time series, select TTFR - Avg and TTR - Avg.

  3. Click Submit.

Your Rich Filter Time Series Chart gadget should look like this:Image Removed

...

Tip

Time series gadgets allow you to report on multiple date fields in the same chart, as seen in this example.

Final result

Dashboard showing a controller, simple gauges, one and two dimensional statistics, flexi chart, and time series chartImage Removed

...