Timepiece - Time in Status for Jira

Gadget

Overview

The Timepiece - Time in Status for Jira Report gadget allows you to display Timepiece reports as tables or charts on Jira dashboards.

A Jira Dashboard with Multiple Timepiece Gadgets
A Jira Dashboard with Multiple Timepiece Gadgets

How to add a Timepiece Gadget to your Jira Dashboard?

To add the Timepiece - Time in Status for Jira Report gadget to your dashboard:

  1. Go to your dashboard and press the Add gadget button on the top right.

  2. Find the gadget named Timepiece - Time in Status for Jira Report on the list and press the Add gadget button next to it.

  3. You should now see the config screen of the gadget on your dashboard. 

Add gadget modal of jira dashboard
Adding Timepiece gadget to Jira dashboard

If you can't see the gadget on the list, please update the app by going to the Manage Apps page of your Jira.

You can add multiple gadgets with different configurations.

Gadget Configuration

When configuring a Timepiece gadget, you can choose one of the following options at the top of the configuration page:

  • Configure gadget by selecting report parameters
    Manually select each report parameter to build your configuration from scratch.

  • Configure gadget with a saved parameter set
    Select one of your saved parameter sets to configure the gadget easily.

Configure gadget by selecting report parameters

Gadget Configuration
Gadget Configuration


Select Issues

Define how the issues to be included in the report will be selected. Click here for details.

Report Type

Define the column structure of the report. Click here for details.

Select whether you want to see your report as an issue list or Average/Sum/Median/Standard Deviation of report values. Click here for details.

Select whether you want to see Data or Charts when the gadget is first displayed.

Statuses

Select the statuses that you want to see in the report.

If you don't select any statuses, Timepiece will show all statuses it encounters in issue histories.

You can define consolidated statuses as well. Click here for details.

Assignees

Select the assignees that you want to see in the report. (For assignee-based reports)

If you don't select any assignees, Timepiece will show all assignees it encounters in issue histories. Click here for details...

DBS Metrics

Define the metrics that will be used for the Duration Between Statuses report type. Click here for details.

Multi Visit Behavior

Select if you want to see the First, Last, Total, or Average duration of status visits for Status Duration reports. Click here for details.

Field

Select issue fields to include in your reports as columns. Click here for details.

Sort

For supported report types, select the column of the report that you want to sort by and select the sort direction. Click here for details.

Filter

For supported report types, define the filter that will be used to filter report data based on report values. Click here for details.

Quick Filter

Configure Quick Filters to let users fine-tune the source data directly in the gadget, without modifying the gadget configuration. This feature allows viewers of the gadget to modify its data (based on pre-configured options) without edit permissions on the gadget or the dashboard. Click here for details.

Highlight

For supported report types, select the cell or row of the report that you want to highlight and define the highlighting rules based on report values. Click here for details.

Calendar

Define the calendar and day length that times will be calculated based on. Click here for details.

Dates

Date filtering can be based on Created Date, Resolution Date, or Update Date of issues.

Filter Dates and Trim History Dates can each be set as static (a fixed date selected from the calendar) or dynamic (a date automatically calculated based on the current time whenever the report is run). The Start Date and End Date of each range can be configured independently. Click here for details.

View

Define the format in which durations will be displayed. Click here for details.

Select how many issues will be shown per page.

Enable / Disable Data Bars for the gadget.

Enable / Disable Visit Counts for the gadget.

Set a Maximum Height for the gadget in pixels. If left empty, the gadget will expand on the page as much as needed. If a max height is set, the gadget will expand only to the given max height and then scroll its content vertically.

Configure gadget with a saved parameter set

Use a saved parameter set to quickly configure the gadget. The gadget will use the exact report parameters defined in the selected set.

Configure Gadget with Saved Parameter Set
Configure Gadget with Saved Parameter Set

If you update the parameter set later from the main Timepiece screen, those changes will automatically be reflected in all gadgets that use it.

See Saving and Loading Report Settings for details about saving parameter sets.

Changing the gadget configuration later

After sacing saving the gadget configuration, if you want to change the gadget settings, click the three dots at the top right of the gadget and select Configure from the menu.

Gadget menu with configure, duplicate, delete, and color options
Gadget Actions Menu

Gadget Output

Once the gadget is configured and saved, it will display the report directly on your Jira dashboard.

Output Formats

You can switch between table and chart views directly from the gadget.

Timepiece Jira gadget displaying data table with highlighted Table and Chart view buttons.
Gadget Output Formats (Table and Chart View)

Issue Limit

Timepiece gadgets have a maximum issue limit per report. If your JQL query or filter returns more issues than the allowed limit, the gadget will not generate the report and will display a warning message. In that case, try narrowing your query by applying additional filters or reducing the date range.

Gadget Functions


Charts and Status History Expanded Report 

For selected report types, the gadgets will display Chart and Status History Expanded buttons, which will display the selection within the gadget.

Gadget showing Chart and Status History Expanded buttons for selected report types
Chart and Status History Icons in Gadget

Drill Down

While working with Aggregate Reports (Average, Sum, Median, Standard Deviation), you can use the drill-down function on each report row to see the issues that made up that aggregate row.

Drill-down of issues in Aggregate Reports
Drill Down Function in Aggregate Reports

Gadget Settings Panel

Access options and display settings directly from the gadget without editing the dashboard or gadget configuration. To open the Settings panel, click the sliders icon at the top-left of the gadget.

Gadget Settings Panel Showing settings icon
Gadget Settings Panel
Agile Metrics gadget settings panel with numbered red frames highlighting report parameters, view options, and data controls.
Settings Panel

View Report Parameters

View Report Parameters allows users to view the report parameters in the gadget from the Settings panel without needing to edit the gadget.

The user does not need edit permissions on the dashboard to access this information. All users with view permissions can see report parameters here.

Report Parameters modal on Timepiece dashboard gadget showing report settings
Report Parameters Details View

View Format

You can change the View Format (days, hours, minutes, etc.), enable/disable Data Bars, adjust the Page Size, and show/hide Visit/Value Counts (for supported report types).


The gadget will return to its configured settings when the page is refreshed


Advanced Table Tools

Users can sort, highlight, and filter directly from the Settings panel without editing the gadget settings.

Filter

Gadget Filter Configuration Modal
Gadget Filter Configuration Modal


Sort

Sort Configuration Modal
Sort Configuration Modal


Highlight

Highlighting in Gadget
Gadget Highlight Rules Modal



Filter and Sort options are also available when you drill down to the details of an aggregate report.

Filter and sort options in aggregate report drill-down
Filter and Sort Options in Drill Down View


The gadget will return to its configured settings when the page is refreshed