Wiki

Clone wiki

Great Gadgets Add-On / Home

Great Gadgets

On this page:

See also:

What is Great Gadgets

Great Gadgets is an app for Jira and Confluence that offers a suite of Jira dashboard gadgets and Confluence macros that you can add to your Jira dashboards or Confluence pages for making them more powerful and this way to improve the efficiency and effectiveness of your team.

The app exists on Atlassian Marketplace in multiple listings, as it follows:

  • Great Gadgets for Jira Cloud - represents the app version that is compatible with Jira Cloud. The gadgets offered by this app can be used in Jira Cloud dashboards.
  • Great Gadgets for Confluence Cloud - represents the app version that is compatible with Confluence Cloud. The gadgets offered by this app are actually Confluence macros and they can be used in Confluence pages. Most of the gadgets offered displays data from Jira, so Jira Cloud is also required for this app to work. You can use this app in combination with Great Gadgets for Jira Cloud or as a stand-alone app, but in this case you must have the StonikByte Connector for Jira Cloud free app installed in your Jira Cloud instance in order to allow the Confluence app to retrieve the necessary data from the Jira Cloud instance.
  • Great Gadgets for Jira Server - represents the app version compatible with Jira Server and Jira Data Center. The gadgets offered by this app can be used in Jira dashboards and they can be also imported as macros in Confluence Server and Confluence Data Center.

Gadgets Offered

The current version of Great Gadgets includes the following gadgets.

GadgetCategoryDescription
Agile,
Project Management
Team Wallboard Gadget Displays the wallboard with the work items from a specified agile board. Use this gadget to see what your team is working on. Read More...
Agile,
Project Management
Release Burnup Burndown Chart Gadget Displays the Burnup or Burndown chart for a Jira issue filter representing your release scope. Use this gadget to track the progress of your project in an agile manner. Read More...
Agile,
Project Management
Sprint Burnup Burndown Chart Gadget Displays the Burnup or Burndown Chart for a selected Agile sprint. Use this gadget to track the progress of your Agile team during the sprint. Read More...
Agile,
Project Management
Team Velocity Gadget Calculates and displays the current average velocity of the Agile (Scrum) team along with the history of previous sprints. The team's velocity is an essential metric that helps the Agile teams not to over-commit during sprint planning meeting, but also helps them to see how they perform from a sprint to another. Read More...
Agile,
Project Management
Cumulative Flow Diagram Displays the cumulative flow diagram (CFD) for the issues in an agile board or filter. It is a stacked area chart that shows the number of tasks in each column of the board or in each status category along the time. Read More...
Agile,
Project Management
Kanban Velocity Gadget Calculates and displays the current average velocity / throughput of the Agile (Kanban) team based on the Jira issue filter or Agile board. Use this gadget to see how many story points your team burns along the time. Read More...
Agile,
Project Management
Cycle Time Trend Gadget Calculates the key Kanban metrics Cycle Time and Lead Time or simply the time between statuses and displays them as a trend chart. Use this gadget to see how fast your team delivers and to identify bottlenecks in your process flow. Read More...
Agile,
Project Management
Control Chart Gadget Control chart based on the cycle time of the issues from a filter. It shows the issues with their cycle time as well as the average line. A custom threshold line can be also added for easily identifying the issues that had a too long cycle time. Use this gadget to see how quickly your team delivers and to identify the issues that took longer than expected. Read More...
Agile,
Project Management
Histogram Chart Gadget Histogram chart based on the cycle time of the issues from a filter. The chart plots the distribution of the issues cycle time as a series of bars. A custom threshold line can be also added for identifying how many issues had a longer cycle time than expected. Use this gadget to see how your team delivers, how many issues were resolved in the expected time frame and how many were not. Read More...
Agile, Project ManagementWork Breakdown Structure (WBS) Gadget This gadget offers the Work Breakdown Structure (WBS) diagram in form of Initiatives > Epic > Parent Tasks > Sub-Tasks for the issues from a Jira filter. With this gadget you have the high-level status of your epics or the entire project. Read More...
Project ManagementIssue Filter Formula Gadget Calculates and displays the result of a simple formula (like SUM, MAX or AVERAGE) on a numeric field of the issues from a specified Jira issue filter. Use this gadget to sum-up and display the total remaining work or the work done in your project, for example. Read More...
Project ManagementAdvanced Issue Filter Formula Gadget Calculates and displays the result of up to 6 math formulas applied against the numerical fields or count of the issues from a Jira filter. For example, you could use this gadget to calculate and display the percent of work done or the percent of spent budget. Read More...
Project Management, Time ManagementCountdown Gadget This gadget shows the remaining time until an upcoming event. Use this gadget to make your team aware of the remaining time until the next project launch or milestone, the Christmas Party or any other important event for your team or company. Read More...
Time ManagementRegional Clock Gadget This gadget shows the current time in a specific location in a digital clock format. It is useful for companies with multiple offices across the world or geographically distributed teams. Use this gadget to make your team members know what the current time is in the other offices so they can better synchronize with the remote people. Read More...

How to use

Great Gadgets app consists in a suite of gadgets that you can use in your Jira dashboards and/or Confluence pages. All the gadgets support the wallboard visualization mode of the Jira dashboards.

See more details below on how to use the gadgets in Jira and Confluence and what you need to have installed for each case.

Using the gadgets in Jira Cloud, Server or Data Center

You can start using the dashboard gadgets right after installing Great Gadgets for Jira Cloud or Great Gadgets for Jira Server. There are no post-installation steps to do as these apps do not have any global (system-level) configuration settings.

To add a gadget to a dashboard:

  • In Jira, go to Dashboards
  • Create a new dashboard or select an existing one
  • Click the Add gadget button of the dashboard
  • In the "Add a gadget" screen, filter by "great" or "StonikByte" to display all the gadgets of the app

Adding a gadget to a dashboard

  • Click the "Add gadget" button of the gadget that you want to add
  • Once you added the gadgets, close the "Add a gadget" screen and continue by entering the gadget settings. See below the instructions for how to configure the gadgets.

Using the gadgets in Confluence Cloud

For using the gadgets in Confluence Cloud you have to install Great Gadgets for Confluence Cloud in your Confluence Cloud instance, no matter if you have or not Great Gadgets for Jira Cloud also installed in your Jira Cloud instance. Once installed, this app makes all the gadgets available as macros in your Confluence Cloud instance.

Most of the macros are based on the data taken from Jira. For these macros to work, you must have a Jira Cloud instance linked with the Confluence Cloud instance. In addition, the Jira Cloud instance must have either Great Gadgets for Jira Cloud or StonikByte Connector for Jira Cloud app installed.

To insert a macro into a Confluence page:

  • Start editing the page where the macro will be inserted
  • Click the "Insert" icon from the top menu bar and start searching for the macro that you want to insert. Search by "great gadgets" or "StonikByte" to display all the macros of the app.

Adding a macro to a Confluence page

  • Continue by entering the macro settings. See below the instructions for how to configure the gadgets.

Configure the macro settings

  • When done, click the Save button from the macro's settings screen. The macro will be displayed on the Confluence page.

An example of macro displayed on a Confluence page

To edit an existing macro from a Confluence page:

  • Start editing the page that contains the macro
  • Hover the mouse over the macro and click the Edit icon

Editing an existing macro from a Confluence page

  • Edit the macro settings. See below the instructions for how to configure the gadgets.
  • When done, click the Save button from the macro's settings screen. The macro will be displayed on the Confluence page according to the new settings.

Using the gadgets in Confluence Server or Data Center

If you have Jira Server or Data Center with Great Gadgets for Jira Server installed, you can also use the gadgets in Confluence Server or Data Center.

All you have to do is to import the gadgets from Jira as macros in Confluence. Follow the Atlassian documentation on how to make the gadgets available in Confluence: https://confluence.atlassian.com/doc/registering-external-gadgets-204050482.html

Using the gadgets in wallboard mode

In Jira (Cloud, Server or Data Center), you can display the gadgets in wallboard mode to make them visible on big TV screens as information radiators, for example.

Gadgets display in wallboard mode

To trigger the wallboard mode, click the View as wallboard option of the Jira dashboard's menu.

Switching to wallboard view

Gadgets Description

Team Wallboard Gadget

Displays the wallboard with the work items from a specified agile board. Supports both Scrum and Kanban board types, for team-managed ("next-gen") and company-managed projects. Use this gadget to see what your team is working on.

Team Wallboard Gadget

The gadget displays the parent tasks (Story, Task, etc) along with their key, summary, assignee, priority and estimate. It can also display the sub-tasks. The displayed estimate is configurable and it can be Story Points, Original Time Estimate or any numerical custom field. Optionally, you can apply one or more of the quick filters of the selected board.

See the settings description below for how to configure the gadget.

The settings of the Team Wallboard gadget

SettingDescription
Gadget titleChoose what to display in the title bar of the gadget.
BoardSelect the agile board to be displayed. The gadget displays only the issues from the selected board that are visible to the current Jira user.
SprintChoose what sprint to display on the wallboard. If Active sprint(s) is selected, the gadget will display the issues of the active sprint; if the board has multiple active sprints, all the issues from these sprints are displayed. This option applies only to the Scrum boards.
Quick filterChoose to apply one or more quick filters of the selected board, for limiting the items displayed. This option is only available for the Cloud version.
Estimation fieldChoose the field that contain the issue estimate or "None" if you do not what the estimate to be displayed.
Show sub-tasksSelect this if you want the sub-tasks to be also displayed on the wallboard. The sub-tasks are displayed with a different color.
Refresh intervalChoose how often the gadget will refresh automatically.

Release Burnup Burndown Chart

Displays the burnup and/or burndown chart for a project release represented by a Jira issue filter. The calculation can be done by Story Points, Original Time Estimate, Issue Count or by any numerical custom field and is based on historical data of every issue from the specified filter. You can also choose to include the sub-tasks in the calculation. The series to be displayed are configurable, thus allowing you to use the gadget as burndown, burnup or both. Use this gadget to track the progress of your project release in an agile manner.

Release Burnup Burndown Chart Gadget

This gadget can also make a forecast (prediction) about when the release will be finished. How the forecast is made? First, the gadget determines the current velocity of your team based on the work done in the previous completed time intervals (Yesterday’s Weather). Then, it determines how many days are necessary to finish the current remaining work assuming that your velocity remains the same and it draws the dashed line accordingly to the determined release end-date.

Optionally, you can choose to display the milestones of the release, like for example at 25%, 50%, 75% of the release timeframe. A past milestone will be displayed in red color, if the Remaining work at that time was higher than Ideal Burndown, or in green color if it was lower, thus indicating if the milestone was reached or not.

Release Burndown Chart with forecast

See the settings description below for how to configure the gadget.

The settings of the Release Burnup Burndown Chart gadget

SettingDescription
Gadget TitleChoose what to display in the title bar of the gadget.
Release Issue FilterThe Jira filter that contains the issues in your release (the scope of your project release). Make sure that the specified filter is shared if you want the other people to visualize the dashboard.
Release Start DateThe start date of your release.
Release End DateThe end date of your release.
Intervals ofIndicates the time interval for calculating the chart data. If you do Agile development, this should be set according to the length of your sprints or iterations.
"Done" meansSpecify how to consider the issue as being "done". If you do Agile development, you should select the Agile board of your team.
Calculate bySpecify on which criteria the calculation to be performed. You can choose between:
* Story Points - the default value, use this option if the issues are estimated in Story Points.
* Original Time Estimate - use this if you use time estimates; calculation will be done in hours. The Scope will be calculated as the sum of the Original Estimate field of all the issues from the filter and each time an issue is marked as done the Burned and Remaining lines will increase/decrease with the amount of hours that is set at Original Estimate for that issue. This option does not consider the time spent (work logged).
* Time Remaining & Time Spent - use this option if you use time estimates and your team logs the worked time on a daily basis; calculation will be done in hours. The Scope will be calculated as the sum of the Time Spent and Time Remaining of all the issues from the filter. Burned is calculated as the sum of Time Spent of all the issues from the filter, plus the sum of Time Remaining of all the issues from the filter that are done. Remaining is calculated as Scope minus Burned. This option does not consider the Original Estimate field.
* Issue Count - use this if you want the calculation to be done by the number of issues.
* Other numerical custom field defined in your Jira instance - pickup the numerical custom field that you use to track or to estimate the issues.
Count also the sub-tasks and their estimateCheck this option if you want the gadget to consider the sub-tasks from the filter and their estimate when doing the calculation.
Forecast made by:Specifies how the forecast about release end-date is made. It takes effect over the Forecast Burndown and Forecast Remaining series in case you choose to display any of them. You can choose between:
The average velocity of all the completed intervals - the forecast will be made based on the average velocity of all the previous completed intervals
The average velocity of the last ? intervals - the forecast will be made based on the average velocity of the last completed intervals, as specified
A fixed velocity of... - the forecast will be made based on the fixed velocity that you introduce manually
Series to DisplayChoose what series to display in the chart. You can select one or more options:
Ideal Burndown - the ideal line specific to a burndown chart. It indicates how the remaining work should evolve in the ideal case. It is calculated based on Scope (see bellow).
Ideal Burnup - the ideal line specific to a burnup chart. It shows how the done (burned) work should evolve in the ideal case. It is calculated based on Scope (see bellow).
Remaining - the total amount of remaining work at that time; it is specific to burndown chart
Burned - the total amount of work done at that time; it is specific to burnup chart
Scope - represents the current release goal - the total amount of work to be done in the release at that time. Select this if you want to see the changes in the release scope along the time.
Forecast Burndown - makes a forecast (prediction) about when the remaining work is finished and displays it as dashed line between the start of the release and the estimated release end-date.
Forecast Remaining - makes a forecast (prediction) about when the remaining work is finished and displays it as dashed line between the end of the Remaining line and the estimated release end-date.
Forecast Burned - makes a forecast (prediction) about when the remaining work is finished and displays it as dashed line between the end of the Burned line and the estimated release end-date.

Tips
To configure the gadget as a "classic" burndown chart, select only the Ideal Burndown and Remaining series.
To configure the gadget as a "classic" burnup chart, select only the Ideal Burnup and Burned series.

Choose also how the ideal series will be calculated. By initial scope means that the first value of the Ideal Burndown line is the value of the Scope series at the start of the release while by current scope means that the first value of the Ideal Burndown line is the current (latest) value of the Scope series. This setting applies also to the Ideal Burnup line.
Show legendCheck this if you want the chart legend to be displayed.
Display milestonesCheck this option and enter the values (percents of the planned release duration) corresponding to the milestones to be displayed. A past milestone will be displayed in red color, if the Remaining work at that time was higher than Ideal Burndown, or in green color if it was lower, thus indicating if the milestone was reached or not. The future milestones are displayed in gray color.
Continue to display data after release end dateCheck this option if you want the chart to still display data even if the release date passed. When this option is checked, the chart lines Scope, Remaining, Burned and forecast will continue after release end-date.
Enable scroll zoomCheck this if you want to be able to zoom-in while scrolling with the mouse wheel over the chart.
Refresh cached data at next displayThis gadget uses data caching for faster display, which means that some data resulted after processing are saved and reused next time when the gadget is loaded. It is recommended to let this option unchecked for faster loading of the gadget. You can check it and then refresh the gadget if you want to clear the cache or you can leave it checked for disabling the usage of data caching.

Related blog articles

Sprint Burnup Burndown Chart

Displays the burnup and/or burndown chart for a specified sprint. The calculation can be done by Story Points, Original Time Estimate, Time Remaining & Time Spent, Issue Count or by any numerical custom field and it is based on historical data of every issue in the sprint. You can also choose to include the sub-tasks in the calculation. The series to be displayed are configurable, thus allowing you to use the gadget as burndown, burnup or both. Use this gadget to track the progress of your Agile team during the sprint.

Sprint Burnup Burndown Chart Gadget

See the settings description below for how to configure the gadget.

The settings of the Burnup Burndown Chart gadget

SettingDescription
Gadget TitleChoose what to display in the title bar of the gadget.
BoardChoose the Scrum board that contains your Agile sprint.
SprintChoose the sprint for which to display the data.
If you select Latest sprint (auto) the most recent sprint that is either closed or active will be used. Use this option if you want not to set the sprint manually all the time.
Calculate bySpecify on which criteria the calculation to be performed. You can choose between:
* Story Points - the default value, use this option if the issues are estimated in Story Points.
* Original Time Estimate - use this if you use time estimates; calculation will be done in hours. The Scope will be calculated as the sum of the Original Estimate field of all the issues from the sprint and each time an issue is marked as done the Burned and Remaining lines will increase/decrease with the amount of hours that is set at Original Estimate for that issue. This option does not consider the time spent (work logged).
* Time Remaining & Time Spent - use this option if you use time estimates and your team logs the worked time on a daily basis; calculation will be done in hours. The Scope will be calculated as the sum of the Time Spent and Time Remaining of all the issues from the sprint. Burned is calculated as the sum of Time Spent of all the issues from the sprint, plus the sum of Time Remaining of all the issues from the sprint that are done. Remaining is calculated as Scope minus Burned. This option does not consider the Original Estimate field.
* Issue Count - use this if you want the calculation to be done by number of issues
* Other numerical custom field defined in your Jira instance - pickup the numerical custom field that you use to track or to estimate the issues.
Count also the sub-tasks and their estimateCheck this option if you want the gadget to consider the sub-tasks from the filter and their estimate when doing the calculation.
Series to DisplayChoose what series to display in the chart. You can select one or more options:
Ideal Burndown - the ideal line specific to a burndown chart. It indicates how the remaining work should evolve during the sprint in the ideal case. It is calculated based on Scope (see bellow).
Ideal Burnup - the ideal line specific to a burnup chart. It shows how the done (burned) work should evolve during the sprint in the ideal case. It is calculated based on Scope (see bellow).
Remaining - the total amount of remaining work at that time; it is specific to burndown chart
Burned - the total amount of work done at that time; it is specific to burnup chart
Scope - represents the current sprint goal - the total amount of work to be done in the sprint. Select this if you want to see the changes in the sprint scope along the time.

Tips
To configure the gadget as a "classic" burndown chart, select only the Ideal Burndown and Remaining series.
To configure the gadget as a "classic" burnup chart, select only the Ideal Burnup and Burned series.

Choose also how the ideal series will be calculated. By initial scope means that the first value of the Ideal Burndown line is the value of the Scope series at the start of the sprint while by current scope means that the first value of the Ideal Burndown line is the current (latest) value of the Scope series. This setting applies also to the Ideal Burnup line.
Show legendCheck this if you want the chart legend to be displayed.
Tilted labels for x-axis (avoid overlapping)Check this to avoid overlapping of the x-axis labels.
Show data tableCheck this option if you want a data table to be displayed along with the chart. The Data tab displays a sprint report based on the current status, which includes the list of completed and not completed issues.
The Data tab showing sprint details
Refresh cached data at next displayThis gadget uses data caching for faster display, which means that some data resulted after processing are saved and reused next time when the gadget is loaded. It is recommended to let this option unchecked for faster loading of the gadget. You can check it and then refresh the gadget if you want to clear the cache or you can leave it checked for disabling the usage of data caching.

Related blog articles

Team Velocity Gadget

Calculates and displays the current average velocity of the Agile team along with the history of previous sprints. The calculation can be done by Story Points, Original Time Estimate, Time Remaining & Time Spent, Issue Count or by any numerical custom field and it is based on historical data of every issue. You can also choose to include the sub-tasks in the calculation. The team's velocity is an essential metric that helps the Agile teams not to over-commit, but also helps them to see how they perform from a sprint to another.

Team Velocity Gadget

Initial Scope - Indicates the scope at the start of the sprint (the team commitment).
Final Scope - Indicates the scope at the end of the sprint, after the eventual scope changes. This helps you to determine if your team tends to change the sprint scope and how much.
Completed - The total amount of work done in that sprint.
Average Velocity - The average velocity calculated as the average of the work done in the last sprints, according to the gadget's settings.

Optionally, additional series can be displayed in the chart:
Scope change - represents the scope change of the sprint, calculated as the difference between Final Scope and Initial Scope.
Added - indicates the amount of work added to the scope after the sprint was started.
Removed - indicates the amount of work removed from the scope after the sprint was started.

See the settings description below for how to configure the gadget.

The settings of the Team Velocity Gadget

SettingDescription
Gadget TitleChoose what to display in the title bar of the gadget.
BoardChoose the Scrum board of your team.
Include onlyOptionally, check Sprints whose names contain... and enter the text to match if you want only specific sprints to be displayed by the chart. This option is useful when you want to filter out some of the sprints of the board.
Also, you can check Sprints completed between... and enter the dates of the time interval if you want to display only the sprints that were completed (closed) in that time interval. This option is useful when you want to see the velocity for sprints in the past. For example, the sprints from the previous year.
Display the chart for the last ? sprintsSpecify the number of previous sprints to be displayed in the chart, starting from the most recent.
Calculate average velocity based on last ? sprintsSpecify the number of previous sprints to be used when calculating the average velocity. Velocity is calculated as the average of the total SPs done in each of these sprints.
Calculate bySpecify on which criteria the calculation to be performed. You can choose between:
* Story Points - the default value, use this if the issues are estimated in Story Points.
* Original Time Estimate - use this if you use time estimates; calculation will be done in hours.
* Time Remaining & Time Spent - use this option if you use time estimates and your team logs the worked time on a daily basis; calculation will be done in hours. The Initial Scope will be calculated as the sum of the Time Spent and Time Remaining of all the issues at the time when the sprint was started. The Final Scope will be calculated as the sum of the Time Spent and Time Remaining of all the issues at the end of the sprint. Completed is calculated as the sum of Time Spent of all the issues from the sprint, plus the sum of Time Remaining of all the issues from the sprint that were done.
* Issue Count - use this if you want the calculation to be done by number of issues
* Other numerical custom field defined in your Jira instance - pickup the numerical custom field that you use to track or to estimate the issues.
Series to DisplayChoose what series to display in the chart. You can select one or more options:
Initial Scope - represents the scope at the start of the sprint (the team commitment).
Final Scope - represents the scope at the end of the sprint, after the eventual scope changes. This helps you to determine if your team tends to change the sprint scope and how much.
Completed - represents the total amount of work done in that sprint.
Average Velocity - The average velocity calculated as the average of the work done in the last sprints, according to the gadget settings.
Scope change - represents the scope change of the sprint, calculated as the difference between Final Scope and Initial Scope.
Added - indicates the amount of work added to the scope after the sprint was started.
Removed - indicates the amount of work removed from the scope after the sprint was started.
Count also the sub-tasks and their estimateCheck this option if you want the gadget to consider the sub-tasks from the filter and their estimate when doing the calculation.
Show legendCheck this if you want the chart legend to be displayed.
Tilted labels for x-axis (avoid overlapping)Check this to avoid overlapping of the x-axis labels.
Show data tableCheck this option if you want a data table to be displayed along with the chart. The Data tab displays all the sprints along with the issues that affected their velocity. The issues that had zeros on all the columns are not displayed.
The Data tab showing sprint details
Refresh cached data at next displayThis gadget uses data caching for faster display, which means that some data resulted after processing are saved and reused next time when the gadget is loaded. It is recommended to let this option unchecked for faster loading of the gadget. You can check it and then refresh the gadget if you want to clear the cache or you can leave it checked for disabling the usage of data caching.

Related blog articles

Cumulative Flow Diagram Gadget

Displays the cumulative flow diagram (CFD) for the issues in an agile board or filter. It is a stacked area chart that shows the number of tasks in each column of the board or in each status category along the time. When you view the data for a particular day, you will know how many work items were present in each column at the end of that day. You can choose to display the chart by Issue Count, Story Points, Original Time Estimate or by any other numerical custom field.

The cumulative flow diagram is one of the most advanced analytics in Agile project management. Use this gadget to determine how stable your flow is and to understand where you need to focus on making your process more predictable. It gives you quantitative and qualitative insight into past and existing problems.

Cumulative Flow Diagram Chart Gadget

Depending on how it was configured, the chart displays multiple series (or "bands"):

Done - The total number of done issues. Depending on the gadget settings, "done" means all the issues with status category "done" (the green-colored statuses from Jira) or the issues in the last column of the selected board.
In Progress - The total number of "In progress" issues. Depending on the gadget settings, "in progress" means all the issues with status category "in progress" (the blue-colored statuses from Jira) or the issues in the middle column(s) of the selected board.
To Do - The total number of issues in "to do". Depending on the gadget settings, "To Do" means all the issues with status category "To Do" (the gray-colored statuses from Jira) or the issues in the first column of the selected board.
Also, if so configured, the gadget can display bands that correspond to the columns of a selected agile board. In this case, the series names will be the same as the column names.

See the settings description below for how to configure the gadget.

The settings of the Cumulative Flow Diagram Gadget

SettingDescription
Gadget TitleChoose what to display in the title bar of the gadget.
DataChoose the agile board of your team or specify a Jira issue filter containing the issues that you want to track. Make sure that the specified filter is shared with the users who will also visualize this gadget.
Calculate bySpecify on which criteria the calculation to be performed. You can choose between:
* Issue Count - the default value, use this if you want the chart to be made by number of issues
* Story Points - use this if you want the chart to be made by summing-up the Story Points of the issues in each band
* Original Time Estimate - use this if you want the chart to be made by summing-up the Original Time Estimate of the issues in each band; the values will be displayed in hours
* Other numerical custom field defined in your Jira instance.
Include the sub-tasksCheck this option if you want the sub-tasks from the selected board or filter to be included in the calculation.
Start DateSpecify the start-date of the time interval for which to display data.
End DateSpecify the end-date of the time interval for which to display data.
Intervals ofIndicates the length of the intervals displayed on X axis.
Chart bands are based onSpecify on which criteria the bands displayed in the chart are determined. You can choose between:
The issue status category - the default value. When using this option, the chart displays 3 bands:
* Done - counts all the issues with status category "done" (the green-colored statuses from Jira)
* In progress - counts all the issues with status category "in progress" (the blue-colored statuses from Jira)
* New - counts all the issues with status category "new" (the gray-colored statuses from Jira)
The columns of the selected board - when using this option, each column of the board has a corresponding band in the chart, displaying the number of issues in that column.
The category of the columns in the selected board - When using this option, the chart displays 3 bands:
* Done - counts all the issues in the last column of the selected board.
* In progress - counts all the issues in the middle column(s) of the selected board.
* New - counts all the issues in the first column of the selected board.
Show legendCheck this if you want the chart legend to be displayed.
Enable scroll zoomCheck this if you want to be able to zoom-in while scrolling with the mouse wheel over the chart.
Continue to display data after end dateCheck this option if you want the chart to still display data even if the end date passed.
Refresh cached data at next displayThis gadget uses data caching for faster display, which means that some data resulted after processing are saved and reused next time when the gadget is loaded. It is recommended to let this option unchecked for faster loading of the gadget. You can check it and then refresh the gadget if you want to clear the cache or you can leave it checked for disabling the usage of data caching.

Related blog articles

Eight “must-have” gadgets for any Kanban dashboard in Jira

Kanban Velocity Gadget

Calculates and displays the current average velocity / throughput of the Agile team that is using Kanban based on a Jira issue filter or an Agile board. The calculation can be done by Story Points, Original Time Estimate, Issue Count or by any numerical custom field and it is based on historical data of every issue. You can also choose to include the sub-tasks in the calculation.

Use this gadget to see how much business value your team delivers along the time and how much work is expected to get done in the next period.

How it works? For each time interval displayed in the chart, it counts the issues that were done in that time interval and it sums-up the estimate that each issue had at the end of that time interval. Please note that this gadget does not consider the issues reopened or re-estimated from an interval to another, so the calculated velocity might differ in comparison with the one displayed by the other gadgets like, for instance, the Release Burnup Burndown Chart gadget.

Kanban Velocity Gadget

Done - The total amount of work done in that time interval, calculated in story points, hours or number of issues according to the gadget's settings.
Velocity - The average velocity / throughput calculated as the average of done work on the last time intervals, according to the gadget's settings.

See the settings description below for how to configure the gadget.

The settings of the Kanban Velocity Gadget

SettingDescription
Gadget TitleChoose what to display in the title bar of the gadget.
DataChoose the board of your team or specify a Jira issue filter representing the scope of your project. Make sure that the specified filter is shared with the users who will also visualize this gadget.
"Done" meansSpecify how to consider the issue as being "done". If you selected an Agile dashboard at Data, you should choose "Issue is in the last column of the selected board".
Interval Start DateSpecify a date when one (any) of the time intervals starts. This is only used by the gadget to determine when the time intervals should start (dates alignment).
Intervals ofSpecify the duration (in weeks) for the time intervals used when calculating and displaying the velocity. If you do Agile development, this should be set according to the length of your sprints or iterations.
Display the chart for the last ? intervalsSpecify the number of previous completed time intervals to be displayed in the chart, starting from the most recent.
Include the current (incomplete) intervalCheck this if you want the interval of the current day to be displayed. Please keep in mind that the current interval is incomplete and the calculation of the current velocity is impacted accordingly.
Calculate average velocity based on last ? intervalsSpecify the number of time intervals to be used when calculating the average velocity. Velocity is calculated as the average of the total SPs done in each of these intervals.
Calculate bySpecify on which criteria the calculation to be performed. You can choose between:
* Story Points - the default value, use this if the issues are estimated in Story Points
* Original Time Estimate - use this if you use time estimates; calculation will be done in hours
* Issue Count - use this if you want the calculation to be done by number of issues
* Other numerical custom field defined in your Jira instance - pickup the numerical custom field that you use to track or to estimate the issues
Count also the sub-tasks and their estimateCheck this option if you want the gadget to consider the sub-tasks from the filter and their estimate when doing the calculation.
Show data tableCheck this option if you want a data table to be displayed along with the chart. The Data tab displays all the time intervals with the issues that affected their velocity. The issues that had zeros on all the columns are not displayed.
The Data tab showing velocity details
Show backlog forecastCheck this option if you want the gadget to display a tab with the current backlog (unresolved issues from the selected filter or board) displayed along with their ETA determined automatically based on the current velocity. Before checking this option, ensure that your backlog is properly ranked, the most urgent issues being on top of the list.
Backlog forecast showing the ETA of the issues
Refresh cached data at next displayThis gadget uses data caching for faster display, which means that some data resulted after processing are saved and reused next time when the gadget is loaded. It is recommended to let this option unchecked for faster loading of the gadget. You can check it and then refresh the gadget if you want to clear the cache or you can leave it checked for disabling the usage of data caching.

Related blog articles

Cycle Time Trend Gadget

Depending on how you configure it, this gadget can calculate the key Kanban metrics like "Cycle Time" or "Lead Time". Or, you can simply calculate the time between two Jira statuses. Use this gadget to see how fast your team delivers and to identify bottlenecks in your process flow.

  • "Cycle Time" is the amount of time that the team spent working on an item without the time that the task spent waiting on the board. Therefore, the Cycle Time should start being measured, when the item task enters a "working" status, not earlier.
  • "Lead Time" is the time from the moment when the request was made by a client and placed on a board to when all the work on it is completed and the request was delivered to the client. So it is the total time the client is waiting for an item to be delivered.

Cycle Time Trend Gadget

The data is displayed for a specified number of time intervals relative to a specified date. For each time interval the gadget identifies those issues from specified filter (or dashboard's filter) that had a cycle completed in that interval, determines the cycle(s) duration, calculates the average time for that interval and displays it in the trend chart.

See the settings description below for how to configure the gadget.

The settings of the Cycle Time Trend Gadget

SettingDescription
Gadget TitleChoose what to display in the title bar of the gadget.
DataChoose the dashboard or Jira issue filter containing the issues for which you want the metrics to be calculated. Make sure that the specified filter is shared with the users who will also visualize this gadget. Check Include the sub-tasks if you want the sub-tasks from the selected board or filter to be included in the calculation.
Cycle startsIndicates what to consider as the start event of a cycle.
Cycle finishesIndicates what to consider as the finish event of a cycle.

Tips
To calculate "Cycle Time", set the following:
* Cycle starts = When the issue entered in a status that has category "In Progress"
* Cycle finishes = When the issue entered in a status that has category "Done"

To calculate "Lead Time", set the following:
* Cycle starts = When the issue was created OR When the issue entered in a status that has category "New"
* Cycle finishes = When the issue entered in a status that has category "Done"
Display data until:Specify the date until the data is displayed. You can choose between:
Previous day (end-of-day) - the data will be displayed until the end of yestarday, without being necessary to manually enter a date.
This date - the data will be displayed until the begining of the specified date.
Interval durationSpecify the duration (in weeks) for the time intervals used when calculating and displaying the average time.
Display the data for ? intervals backSpecify the number of time intervals to be displayed in the chart relative to the date specified at "Display data until".
Calculate inSpecify in what time unit measure the results will be displayed.
Don't count weekendsCheck this option if you want to exclude the weekends (Saturdays and Sundays) from the cycle time calculation.
Show legendCheck this option if you want the chart legend to be displayed.
Show data tableCheck this option if you want a data table to be displayed along with the chart. The Data tab displays, for every time interval in the chart, the issues along with their cycle time details and the average calculation.
The Data tab showing the issues along with their cycle time
Refresh cached data at next displayThis gadget uses data caching for faster display, which means that some data resulted after processing are saved and reused next time when the gadget is loaded. It is recommended to let this option unchecked for faster loading of the gadget. You can check it and then refresh the gadget if you want to clear the cache or you can leave it checked for disabling the usage of data caching.

Related blog articles

Seven “must-have” gadgets for any Kanban dashboard in Jira

Control Chart Gadget

Depending on how you configure it, this gadget can calculate the key Kanban metrics like "Cycle Time" or "Lead Time" for the issues from a specified filter and for a certain time interval. It shows the issues with their cycle time in a scatter plot chart. Optionally, the average cycle time can be displayed as a separate line and a custom threshold line can be added for easily identifying the issues that had an abnormally long cycle time.

You can use this gadget to see how quickly your team delivers and to identify the issues that took longer than expected. Hovering the mouse over an issue from the chart will display a tooltip with issue's details like issue key or cycle time.

Control Chart Gadget

The data is displayed for a specified time interval or an interval relative to the current day. The gadget identifies those issues from the specified filter (or dashboard's filter) that had a cycle completed in this interval, determines the cycle(s) duration and displays them in the chart along with the date when their cycle was finished.

See the settings description below for how to configure the gadget.

The settings of the Control Chart Gadget

SettingDescription
Gadget TitleChoose what to display in the title bar of the gadget.
DataChoose the dashboard or Jira issue filter containing the issues for which you want the metrics to be calculated. Make sure that the specified filter is shared with the users who will also visualize this gadget. Check Include the sub-tasks if you want the sub-tasks from the selected board or filter to be included in the calculation.
Cycle startsIndicates what to consider as the start event of a cycle.
Cycle finishesIndicates what to consider as the finish event of a cycle.

Tips
To calculate "Cycle Time", set the following:
* Cycle starts = When the issue entered in a status that has category "In Progress"
* Cycle finishes = When the issue entered in a status that has category "Done"

To calculate "Lead Time", set the following:
* Cycle starts = When the issue was created OR When the issue entered in a status that has category "New"
* Cycle finishes = When the issue entered in a status that has category "Done"
Time interval:Specify the time interval for which to display data. You can specify a fixed time interval or a number of days back relative to current date, the current day being included.
Calculate inSpecify in what time unit measure the results will be displayed.
Don't count weekendsCheck this option if you want to exclude the weekends (Saturdays and Sundays) from the cycle time calculation.
Display average lineCheck this option if you want the chart to display a line with the average cycle time for the specified time interval.
Display threshold lineCheck this option if you want the chart to display a line representing a threshold. The issues that have a cycle time higher than the specified Threshold value will be colored in red.
Display percentile linesCheck this option and enter the values (percents) corresponding to the percentiles to be displayed. A percentile is a value from the data set that splits the data into two pieces: the lower piece contains the percent of the data, and the upper piece contains the rest of the data. For example the 75% percentile will be displayed as a horizontal line having 75% of the issues under it and the rest of the issues (25%) over it.
Use logarithmic scale for the vertical axisCheck this option if you want the chart to display logarithmic scale instead of linear scale for the Y axis.
Show legendCheck this option if you want the chart legend to be displayed.
Show data tableCheck this option if you want a data table to be displayed along with the chart. The Data tab displays the issues along with their cycle time details and the average calculation.
The Data tab showing the issues along with their cycle time

Related blog articles

Seven “must-have” gadgets for any Kanban dashboard in Jira

Histogram Chart Gadget

Depending on how you configure it, this gadget can calculate the key Kanban metrics like "Cycle Time" or "Lead Time" for the issues from a specified filter and for a certain time interval and displays their distribution as a histogram. Optionally, the average cycle time can be displayed as a separate line and a custom threshold line can be added for easily identifying the issues that had an abnormally long cycle time.

You can use this gadget to see how your team delivers, how many issues were resolved in the expected time frame and how many were not.

Histogram Chart Gadget

The gadget identifies those issues from the specified filter (or dashboard's filter) that had a cycle completed in the specified time interval, determines the cycle(s) duration and then groups them into "bins" indicating how many values fall into ranges.

See the settings description below for how to configure the gadget.

The settings of the Histogram Chart Gadget

SettingDescription
Gadget TitleChoose what to display in the title bar of the gadget.
DataChoose the dashboard or Jira issue filter containing the issues for which you want the metrics to be calculated. Make sure that the specified filter is shared with the users who will also visualize this gadget. Check Include the sub-tasks if you want the sub-tasks from the selected board or filter to be included in the calculation.
Split range criteriaChoose how to define the segmented columns (bins). If you choose Attempt to split in ? equal intervals, the gadget will try to divide the range in equal intervals, although it is not always possible to split in the number of intervals that you specified. So the number that you enter is actually a "desired" number. If you choose Split by using these custom thresholds the range will be divided according to the entered thresholds. In this case, you must manually introduce the thresholds separated by comma (for example: 100, 200, 300, 400, 500).
Cycle startsIndicates what to consider as the start event of a cycle.
Cycle finishesIndicates what to consider as the finish event of a cycle.

Tips
To calculate "Cycle Time", set the following:
* Cycle starts = When the issue entered in a status that has category "In Progress"
* Cycle finishes = When the issue entered in a status that has category "Done"

To calculate "Lead Time", set the following:
* Cycle starts = When the issue was created OR When the issue entered in a status that has category "New"
* Cycle finishes = When the issue entered in a status that has category "Done"
Time interval:Specify the time interval for which to display data. You can specify a fixed time interval or a number of days back relative to current date, the current day being included.
Calculate the cycle time inSpecify in what time unit measure the cycle time will be calculated and displayed.
Don't count weekendsCheck this option if you want to exclude the weekends (Saturdays and Sundays) from the cycle time calculation.
Display average lineCheck this option if you want the chart to display a vertical line with the average cycle time for the specified time interval.
Display threshold lineCheck this option if you want the chart to display a vertical line representing a threshold. The issues that have a cycle time higher than the specified Threshold value will be colored in red.
Display percentile linesCheck this option and enter the values (percents) corresponding to the percentiles to be displayed as vertical lines. A percentile is a value from the data set that splits the data into two pieces: the lower piece contains the percent of the data, and the upper piece contains the rest of the data. For example the 75% percentile will be displayed as a horizontal line having 75% of the issues under it and the rest of the issues (25%) over it.
Show legendCheck this option if you want the chart legend to be displayed.
Show data tableCheck this option if you want a data table to be displayed along with the chart. The Data tab displays the issues along with their cycle time details and the average calculation.


The Data tab showing the issues along with their cycle time|

Work Breakdown Structure (WBS) Gadget

This gadget offers the Work Breakdown Structure (WBS) diagram in form of Initiatives > Epic > Parent Tasks > Sub-Tasks for the issues from a Jira filter. The initiatives are those issues defined in Atlassian's Advanced Roadmap app (formerly Jira Portfolio) that are superior to epics in the issues hierarchy. With this gadget you have the high-level status of your epics or the entire project. The issues displayed are ordered according to the ORDER BY clause of the filter used.

Work Breakdown Structure (WBS) Gadget

See the settings description below for how to configure the gadget.

The settings of the WBS Gadget

SettingDescription
Gadget TitleChoose what to display in the title bar of the gadget.
Saved FilterThe Jira filter containing the Jira issues that you want to display. It can be a filter containing one or more intiatives or epics, or it can be your entire project. Make sure that the specified filter is shared if you want the other people to visualize the dashboard.
ExpandSpecify how many levels to be expanded by default right after displaying the gadget.

Related blog articles

Issue Filter Formula Gadget

Calculates and displays the result of a simple formula (like SUM, MAX or AVERAGE) on a numeric field of the issues from a specified Jira issue filter. Use this gadget to display, for instance, the total remaining work or the the work done in your project.

Formula Gadget

See the settings description below for how to configure the gadget.

The settings of the Formula Gadget

SettingDescription
Gadget TitleChoose what to display in the title bar of the gadget.
The Meaning of the DataSpecify the text to be displayed under the calculated value representing the meaning of that value.
Saved FilterThe Jira filter containing the Jira issues for which you want to do the calculation. Make sure that the specified filter is shared if you want the other people to visualize the dashboard.
Calculation fieldSelect the Jira issue field to use for calculation. You can chose from a list of the numeric fields available in your Jira instance.

NOTE On Jira Server and Data Center the scripted fields added via ScriptRunner app are also available for selection here, but only if they are configured as numerical fields in the Custom Fields area of Jira Administration. More exactly, their Search Template must be set to Number Search.
FormulaChoose the basic formula (Sum, Average, Min or Max) for being used in calculation.
Math transformationOptionally, you can apply an extra math formula over the result of the basic formula. With this extra math formula practically you will modify the final result with any operation or math function as you want. The formula must contain "x", which represents the result of the initial basic formula.
A good example is when you use a basic formula against a time field of Jira, like Original Estimate or Remaining Estimate. Jira stores the values of these fields in seconds and the result of the basic formula will be also in seconds. To transform in hours, you must apply the math transformation "x/3600".
Decimal placesChoose the number of decimals to be used when displaying the final result.

Related blog articles

Advanced Issue Filter Formula Gadget

This gadget allows displaying the result of up to 6 calculations of math formulas applied against the numerical fields or the count of the issues from multiple Jira filters. Comparing with Issue Filter Formula Gadget, it allows displaying up to 6 calculations results (instead of one) and combines data from up to 6 filters (instead of one) and can do more advanced calculations (not only SUM, COUNT, AVG, MIN or MAX). For example, you could use this gadget to calculate and display the percent of work done or the percent of spent budget.

How it works? The gadget lets you define up to 6 variables ('a', 'b', 'c', 'd', 'e' and 'f') calculated as COUNT, SUM, MAX, MIN or AVERAGE for a numeric field of the issues from a specified Jira issue filter. Then, you can combine these variables in up to 6 math formulas and display their results.

The Advanced Issue Filter Formula Gadget

See the settings description below for how to configure the gadget.

The settings of the Advanced Issue Filter Formula Gadget

SettingDescription
Gadget TitleChoose what to display in the title bar of the gadget.
VariablesSelect the variable(s) 'a', 'b', 'c', 'd', 'e' or 'f' that you need and specify how they are calculated. For each of them choose the Formula (SUM, MIN, MAX, COUNT or AVG) that is applied against the selected Field of the issues returned by the selected Filter.

NOTE On Jira Server and Data Center the scripted fields added via ScriptRunner app are also available for selection in the Field dropdown list, but only if they are configured as numerical fields in the Custom Fields area of Jira Administration. More exactly, their Search Template must be set to Number Search.
Data To DisplayDecide what numbers to display in the gadget by entering Math Formulas which combine one or more of the selected variables. For each formula, enter also a Label and specify with how many Decimals the formula result shall be displayed.

Example: Let's assume that you want to display the percent of work done (by story points) for a project. Here are the steps to perform:

  • You have to create two filters:
    • a filter that returns all the issues from the project.
    • a filter that returns only the issues from the project that are done.
  • Then, you have to define two variables:
    • 'a' that will be calculated as the SUM of Story Points field of the issues from the first filter. This represents the total estimated work, in story points.
    • 'b' that will be calculated as the SUM of Story Points field of the issues from the second filter. This represents the total amount of work done, in story points.
  • Finally, display the numbers by entering the following math formulas:
    • 'a' - to display the value of 'a' variable representing the total estimated work.
    • 'b' - to display the value of 'b' variable representing the total work done.
    • '(b / a) * 100' - to calculate and display the percent of work done.

NOTE The gadget displays 'NaN' (Not a Number) if the result of the formula cannot be calculated. This can happen in case of division by zero or when one of the variables cannot be calculated (for example, the AVG or MAX for a filter that returns no issues).

Countdown Gadget

This gadget shows the remaining time until an upcoming event. Use this gadget to make your team aware of the remaining time until the next project launch or milestone, the Christmas Party or any other important event for your team or company.

Countdown Gadget

See the settings description below for how to configure the gadget.

The settings of the Countdown Gadget

SettingDescription
Gadget TitleChoose what to display in the title bar of the gadget.
DateSpecify the date and time for the upcoming event.
Top lineThe text to be displayed on the line above the remaining time.
Bottom lineThe text to be displayed on the line below the remaining time.
Don't count weekendsCheck this option if you want the gadget not to count the weekends (Saturdays and Sundays). This option could be used to determine how many effective workdays remained until a specific milestone.

Regional Clock Gadget

This gadget shows the current time in a specific location in a digital clock format. It is useful for companies with multiple offices across the world or geographically distributed teams. Use this gadget to make your team members know what the current time is in the other offices so they can better synchronize with the remote people.

Digital Clock Gadget

See the settings description below for how to configure the gadget.

The settings of the Digital Clock Gadget

SettingDescription
Gadget TitleChoose what to display in the title bar of the gadget.
Top LineSpecify the location for being displayed on the top line.
RegionSelect the region for which the time to be displayed.
Time ZoneSelect the city or the time zone for which the time to be displayed.
Show DateCheck this if you want the current date to be also displayed.

Migration Steps

See below some details about migration to Data Center or Cloud. If you have additional questions or need assistance with the app migration, please contact StonikByte Support at support@stonikbyte.com.

Migration from Server to Data Center

If you migrate your Jira instance from Server to Data Center by preserving the existing Jira data, there are no special steps to follow in order to migrate Great Gadgets app. After applying the new Data Center specific license key, the app will continue to work as before.

If you migrate to Data Center without preserving the existing Jira data, this will be like a new app installation. You will have to create new Jira dashboards and configure the app gadgets from scratch.

Migration from Server / Data Center to Cloud

The app has a Cloud version that offers the same functionality as the Server / Data Center version. It can be found on Atlassian Marketplace. If you migrate your Jira instance from Server / Data Center to Cloud, this will be like a new app installation. You will have to reconfigure the app gadgets from scratch. No other migration steps are needed. There is no data to migrate because this app just processes and displays issue-related data taken from Jira.

To determine the gadgets usage in your Jira Server / Data Center instance, you can run this SQL query on the Jira database:

SELECT portletconfiguration.gadget_xml, portalpage.pagename, portalpage.id, portalpage.username
FROM portletconfiguration INNER JOIN portalpage
ON portletconfiguration.portalpage = portalpage.id
WHERE portletconfiguration.gadget_xml LIKE '%com.stonikbyte.great.gadgets%'

This returns a list with the gadget identifier (gadget_xml), the name (pagename) and the identifier (id) of the dashboard where the gadget is located, and the user who added the gadget to dashboard (username).

Determining the gadgets usage on Jira Server

Updated