Jira units, metrics, and properties
Jira units, metrics, and properties
This page describes the available units, metrics, and properties when creating a chart for a Jira data source. See also these related guides:
Units
Units are the numbers shown in the charts. Unit can be any of these:
Issue | The default unit is Issue i.e. a chart displays the count of issues and subtasks. |
|---|---|
Points | Jira's default Story Points estimation field. |
Number field | Your custom Number fields can be used as unit in the charts. |
Dropdown field | Your custom Dropdown fields can be mapped as units. |
Time in state | Timing metrics (reaction, lead, cycle time). These are calculated for all issues and subtasks. |
Logged time | Time logged to any of your time tracking fields (worklogs). The selected date range refers to when the time was logged. |
All units share these characteristics:
They can be filtered by any property of an issue
They can be summarized as sum, average, or median
They can be formatted as numbers, monetary units, or time units
The resulting charts can be exported as CSV or JSON file
Metrics
Metrics are the calculations performed on the selected unit.
Total | Shows the total amount of the selected unit in the selected data sources. |
|---|---|
Not started | Work not started according to the workflow settings. |
Not started & In progress | Incomplete work according to the workflow settings. |
In progress | Work in progress according to the workflow settings. |
Created (within date range) | Issues by creation date (issue creation date from the Jira API). |
Completed (within date range) | Issues by Date completed. The last date & time when the issue was completed (moved to a board column mapped as done in the workflow settings). |
By Due date | Issues by Due date. Includes the items that have a Due date within the selected date range (regardless of their workflow state). |
By Start date | Issues by Start date. Includes the items that have a Start date within the selected date range (regardless of their workflow state). |
By [custom Date field] | Issues by a custom Date column. Includes the items that have the date within the specified date range (regardless of their workflow state). |
Reaction time (avg, completed items) | Time before the work was started. The average time spent in the states mapped as Not started in the workflow settings. |
Reaction time (sum, completed items) | Time before the work was started. The sum of time spent in the states mapped as Not started in the workflow settings. |
Cycle time (avg, completed items) | Time from start to completion. The average time spent in the states mapped as In progress in the workflow settings. |
Cycle time (sum, completed items) | Time from start to completion The sum of time spent in the states mapped as In progress in the workflow settings. |
Lead time (avg, completed items) | Lead time (avg) = (Reaction time + Cycle time) (avg) |
Lead time (sum, completed items) | Lead time (sum) = (Reaction time + Cycle time) (sum) |
Time in state (avg, completed items) | Time spent in specific workflow states. Use the filter to select the states. |
Time in state (sum, completed items) | Time spent in specific workflow states. Use the filter to select the states. |
Issue properties
Issue properties that can be displayed as columns in a Task list.
Assignee | The assigned person |
|---|---|
Assignees | The assigned persons (if multiple) |
Blocked | Whether the issue is blocked by some other issue. |
Completed on time | Was the item completed before the due date (true/false). |
Component | The Component the issue is currently assigned to. |
Created by | The person who created the issue. |
Cycle time | Time from start to completion. The time spent in the states mapped as In progress in the workflow settings. |
Cycle time (working hours) | Time from start to completion. The time spent in the states mapped as In progress in the workflow settings. Time is calculated only within the set working days and hours. |
Data source | The Jira board the item is currently in, according to the JQL query associated with the board. |
Date completed | The last date & time when the issue was completed (moved to a board column mapped as done in the workflow settings). |
Date created | Item creation date (from the Jira API). |
Date updated | Last update date (from the Jira API) |
Due date | Issue Due date. |
Epic | The Epic the issue is currently assigned to. |
Estimate | Jira's default Story Points estimation field. |
FixVersions | The FixVersions the issue is currently assigned to. |
Issue ID | Unique identifier of the issue by Jira. |
Issue name | Name of the issue. |
Issue type | Epic, Task, Bug, Sub-task, Story, or any of your custom issue types. |
Jira status | The Jira status the issue is currently in. |
Label | The labels added to the issue. |
Lead time | Reaction time + Cycle time |
Lead time (working hours) | Reaction time + Cycle time. Time is calculated only within the set working days and hours. |
Mapped state | Mapped workflow state according to the workflow settings. Either Not started, In progress, or Done. |
Moved to mapped state | Time when the item was moved to its current mapped workflow state. |
Moved to workflow state | Time when the item was moved to its current workflow state. |
Original estimate | The estimated effort (in hours or story points) to complete a piece of work in Jira. |
Parent | Parent item of the issue (if any). |
Priority | The Priority of the issue. |
Project | The Project the issue is currently in. |
Rank | Issue position in a Jira board (above or below another issue). Based on Jira's LexoRank which produces non-readable sequence of characters that can be used for sorting issess according to their position in a board. |
Reaction time | Time before the work was started. The time spent in the states mapped as Not started in the workflow settings. |
Reaction time (working hours) | Time before the work was started. The time spent in the states mapped as Not started in the workflow settings. Time is calculated only within the set working days and hours. |
Reopened | Whether the issue has been reopened (true/false) |
Resolution | The Jira Resolution field indicates the final outcome of an issue, showing how it was closed (e.g., Fixed, Won't Do, Duplicate). |
Sprint (assigned to) | The Sprints the issue has been assigned to. |
Sprint (completed in) | The Sprint the issue was completed in. |
Start date | Issue Start date. |
State (open/done) | Whether the issue's mapped state is Open (Not started or In progress) or Done. |
Time in progress | The time spent in the states mapped as In progress in the workflow settings. |
Time in progress (working hours) | The time spent in the states mapped as In progress in the workflow settings. Time is calculated only within the set working days and hours. |
Time in workflow state | The time spent in the current workflow state. |
Time logged by (Work logged) | The person who logged the time into the time tracking field. |
Timings | The total time spent in each workflow state. |
Work done | Total amount of hours logged for the issue. |
Work left | Original estimate - Work done |
Work logged | Total amount of hours logged for the issue. Can be filtered according to when the hours were logged. |
Workflow state | The current workflow state of the issue. |
This page describes the available units, metrics, and properties when creating a chart for a Jira data source. See also these related guides:
Units
Units are the numbers shown in the charts. Unit can be any of these:
Issue | The default unit is Issue i.e. a chart displays the count of issues and subtasks. |
|---|---|
Points | Jira's default Story Points estimation field. |
Number field | Your custom Number fields can be used as unit in the charts. |
Dropdown field | Your custom Dropdown fields can be mapped as units. |
Time in state | Timing metrics (reaction, lead, cycle time). These are calculated for all issues and subtasks. |
Logged time | Time logged to any of your time tracking fields (worklogs). The selected date range refers to when the time was logged. |
All units share these characteristics:
They can be filtered by any property of an issue
They can be summarized as sum, average, or median
They can be formatted as numbers, monetary units, or time units
The resulting charts can be exported as CSV or JSON file
Metrics
Metrics are the calculations performed on the selected unit.
Total | Shows the total amount of the selected unit in the selected data sources. |
|---|---|
Not started | Work not started according to the workflow settings. |
Not started & In progress | Incomplete work according to the workflow settings. |
In progress | Work in progress according to the workflow settings. |
Created (within date range) | Issues by creation date (issue creation date from the Jira API). |
Completed (within date range) | Issues by Date completed. The last date & time when the issue was completed (moved to a board column mapped as done in the workflow settings). |
By Due date | Issues by Due date. Includes the items that have a Due date within the selected date range (regardless of their workflow state). |
By Start date | Issues by Start date. Includes the items that have a Start date within the selected date range (regardless of their workflow state). |
By [custom Date field] | Issues by a custom Date column. Includes the items that have the date within the specified date range (regardless of their workflow state). |
Reaction time (avg, completed items) | Time before the work was started. The average time spent in the states mapped as Not started in the workflow settings. |
Reaction time (sum, completed items) | Time before the work was started. The sum of time spent in the states mapped as Not started in the workflow settings. |
Cycle time (avg, completed items) | Time from start to completion. The average time spent in the states mapped as In progress in the workflow settings. |
Cycle time (sum, completed items) | Time from start to completion The sum of time spent in the states mapped as In progress in the workflow settings. |
Lead time (avg, completed items) | Lead time (avg) = (Reaction time + Cycle time) (avg) |
Lead time (sum, completed items) | Lead time (sum) = (Reaction time + Cycle time) (sum) |
Time in state (avg, completed items) | Time spent in specific workflow states. Use the filter to select the states. |
Time in state (sum, completed items) | Time spent in specific workflow states. Use the filter to select the states. |
Issue properties
Issue properties that can be displayed as columns in a Task list.
Assignee | The assigned person |
|---|---|
Assignees | The assigned persons (if multiple) |
Blocked | Whether the issue is blocked by some other issue. |
Completed on time | Was the item completed before the due date (true/false). |
Component | The Component the issue is currently assigned to. |
Created by | The person who created the issue. |
Cycle time | Time from start to completion. The time spent in the states mapped as In progress in the workflow settings. |
Cycle time (working hours) | Time from start to completion. The time spent in the states mapped as In progress in the workflow settings. Time is calculated only within the set working days and hours. |
Data source | The Jira board the item is currently in, according to the JQL query associated with the board. |
Date completed | The last date & time when the issue was completed (moved to a board column mapped as done in the workflow settings). |
Date created | Item creation date (from the Jira API). |
Date updated | Last update date (from the Jira API) |
Due date | Issue Due date. |
Epic | The Epic the issue is currently assigned to. |
Estimate | Jira's default Story Points estimation field. |
FixVersions | The FixVersions the issue is currently assigned to. |
Issue ID | Unique identifier of the issue by Jira. |
Issue name | Name of the issue. |
Issue type | Epic, Task, Bug, Sub-task, Story, or any of your custom issue types. |
Jira status | The Jira status the issue is currently in. |
Label | The labels added to the issue. |
Lead time | Reaction time + Cycle time |
Lead time (working hours) | Reaction time + Cycle time. Time is calculated only within the set working days and hours. |
Mapped state | Mapped workflow state according to the workflow settings. Either Not started, In progress, or Done. |
Moved to mapped state | Time when the item was moved to its current mapped workflow state. |
Moved to workflow state | Time when the item was moved to its current workflow state. |
Original estimate | The estimated effort (in hours or story points) to complete a piece of work in Jira. |
Parent | Parent item of the issue (if any). |
Priority | The Priority of the issue. |
Project | The Project the issue is currently in. |
Rank | Issue position in a Jira board (above or below another issue). Based on Jira's LexoRank which produces non-readable sequence of characters that can be used for sorting issess according to their position in a board. |
Reaction time | Time before the work was started. The time spent in the states mapped as Not started in the workflow settings. |
Reaction time (working hours) | Time before the work was started. The time spent in the states mapped as Not started in the workflow settings. Time is calculated only within the set working days and hours. |
Reopened | Whether the issue has been reopened (true/false) |
Resolution | The Jira Resolution field indicates the final outcome of an issue, showing how it was closed (e.g., Fixed, Won't Do, Duplicate). |
Sprint (assigned to) | The Sprints the issue has been assigned to. |
Sprint (completed in) | The Sprint the issue was completed in. |
Start date | Issue Start date. |
State (open/done) | Whether the issue's mapped state is Open (Not started or In progress) or Done. |
Time in progress | The time spent in the states mapped as In progress in the workflow settings. |
Time in progress (working hours) | The time spent in the states mapped as In progress in the workflow settings. Time is calculated only within the set working days and hours. |
Time in workflow state | The time spent in the current workflow state. |
Time logged by (Work logged) | The person who logged the time into the time tracking field. |
Timings | The total time spent in each workflow state. |
Work done | Total amount of hours logged for the issue. |
Work left | Original estimate - Work done |
Work logged | Total amount of hours logged for the issue. Can be filtered according to when the hours were logged. |
Workflow state | The current workflow state of the issue. |
This page describes the available units, metrics, and properties when creating a chart for a Jira data source. See also these related guides:
Units
Units are the numbers shown in the charts. Unit can be any of these:
Issue | The default unit is Issue i.e. a chart displays the count of issues and subtasks. |
|---|---|
Points | Jira's default Story Points estimation field. |
Number field | Your custom Number fields can be used as unit in the charts. |
Dropdown field | Your custom Dropdown fields can be mapped as units. |
Time in state | Timing metrics (reaction, lead, cycle time). These are calculated for all issues and subtasks. |
Logged time | Time logged to any of your time tracking fields (worklogs). The selected date range refers to when the time was logged. |
All units share these characteristics:
They can be filtered by any property of an issue
They can be summarized as sum, average, or median
They can be formatted as numbers, monetary units, or time units
The resulting charts can be exported as CSV or JSON file
Metrics
Metrics are the calculations performed on the selected unit.
Total | Shows the total amount of the selected unit in the selected data sources. |
|---|---|
Not started | Work not started according to the workflow settings. |
Not started & In progress | Incomplete work according to the workflow settings. |
In progress | Work in progress according to the workflow settings. |
Created (within date range) | Issues by creation date (issue creation date from the Jira API). |
Completed (within date range) | Issues by Date completed. The last date & time when the issue was completed (moved to a board column mapped as done in the workflow settings). |
By Due date | Issues by Due date. Includes the items that have a Due date within the selected date range (regardless of their workflow state). |
By Start date | Issues by Start date. Includes the items that have a Start date within the selected date range (regardless of their workflow state). |
By [custom Date field] | Issues by a custom Date column. Includes the items that have the date within the specified date range (regardless of their workflow state). |
Reaction time (avg, completed items) | Time before the work was started. The average time spent in the states mapped as Not started in the workflow settings. |
Reaction time (sum, completed items) | Time before the work was started. The sum of time spent in the states mapped as Not started in the workflow settings. |
Cycle time (avg, completed items) | Time from start to completion. The average time spent in the states mapped as In progress in the workflow settings. |
Cycle time (sum, completed items) | Time from start to completion The sum of time spent in the states mapped as In progress in the workflow settings. |
Lead time (avg, completed items) | Lead time (avg) = (Reaction time + Cycle time) (avg) |
Lead time (sum, completed items) | Lead time (sum) = (Reaction time + Cycle time) (sum) |
Time in state (avg, completed items) | Time spent in specific workflow states. Use the filter to select the states. |
Time in state (sum, completed items) | Time spent in specific workflow states. Use the filter to select the states. |
Issue properties
Issue properties that can be displayed as columns in a Task list.
Assignee | The assigned person |
|---|---|
Assignees | The assigned persons (if multiple) |
Blocked | Whether the issue is blocked by some other issue. |
Completed on time | Was the item completed before the due date (true/false). |
Component | The Component the issue is currently assigned to. |
Created by | The person who created the issue. |
Cycle time | Time from start to completion. The time spent in the states mapped as In progress in the workflow settings. |
Cycle time (working hours) | Time from start to completion. The time spent in the states mapped as In progress in the workflow settings. Time is calculated only within the set working days and hours. |
Data source | The Jira board the item is currently in, according to the JQL query associated with the board. |
Date completed | The last date & time when the issue was completed (moved to a board column mapped as done in the workflow settings). |
Date created | Item creation date (from the Jira API). |
Date updated | Last update date (from the Jira API) |
Due date | Issue Due date. |
Epic | The Epic the issue is currently assigned to. |
Estimate | Jira's default Story Points estimation field. |
FixVersions | The FixVersions the issue is currently assigned to. |
Issue ID | Unique identifier of the issue by Jira. |
Issue name | Name of the issue. |
Issue type | Epic, Task, Bug, Sub-task, Story, or any of your custom issue types. |
Jira status | The Jira status the issue is currently in. |
Label | The labels added to the issue. |
Lead time | Reaction time + Cycle time |
Lead time (working hours) | Reaction time + Cycle time. Time is calculated only within the set working days and hours. |
Mapped state | Mapped workflow state according to the workflow settings. Either Not started, In progress, or Done. |
Moved to mapped state | Time when the item was moved to its current mapped workflow state. |
Moved to workflow state | Time when the item was moved to its current workflow state. |
Original estimate | The estimated effort (in hours or story points) to complete a piece of work in Jira. |
Parent | Parent item of the issue (if any). |
Priority | The Priority of the issue. |
Project | The Project the issue is currently in. |
Rank | Issue position in a Jira board (above or below another issue). Based on Jira's LexoRank which produces non-readable sequence of characters that can be used for sorting issess according to their position in a board. |
Reaction time | Time before the work was started. The time spent in the states mapped as Not started in the workflow settings. |
Reaction time (working hours) | Time before the work was started. The time spent in the states mapped as Not started in the workflow settings. Time is calculated only within the set working days and hours. |
Reopened | Whether the issue has been reopened (true/false) |
Resolution | The Jira Resolution field indicates the final outcome of an issue, showing how it was closed (e.g., Fixed, Won't Do, Duplicate). |
Sprint (assigned to) | The Sprints the issue has been assigned to. |
Sprint (completed in) | The Sprint the issue was completed in. |
Start date | Issue Start date. |
State (open/done) | Whether the issue's mapped state is Open (Not started or In progress) or Done. |
Time in progress | The time spent in the states mapped as In progress in the workflow settings. |
Time in progress (working hours) | The time spent in the states mapped as In progress in the workflow settings. Time is calculated only within the set working days and hours. |
Time in workflow state | The time spent in the current workflow state. |
Time logged by (Work logged) | The person who logged the time into the time tracking field. |
Timings | The total time spent in each workflow state. |
Work done | Total amount of hours logged for the issue. |
Work left | Original estimate - Work done |
Work logged | Total amount of hours logged for the issue. Can be filtered according to when the hours were logged. |
Workflow state | The current workflow state of the issue. |