GitLab units, metrics, and properties
GitLab units, metrics, and properties
This page describes the available units, metrics, and issue properties when creating a chart for a GitLab data source.
See also these related resources
Chart editor guide
Screenful Knowledge base
Units
Units are the numbers shown in the charts. Unit can be any of these:
Issues and MRs | By default, charts display the count of issues, tasks, and merge requests. |
|---|---|
Hours | GitLab's estimate field in the time tracking feature. |
Points | GitLab issue weight |
Time in state | Timing metrics (reaction, lead, cycle time). These are calculated for all issues, tasks, and merge requests. |
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
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 Linear API). |
Completed (within date range) | Issues by Date completed. The last date & time when the issue was completed (moved to a state 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). |
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) |
Completed on time | Was the item completed before the due date (true/false). |
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 GitLab board the item is currently in. |
Date completed | The last date & time when the issue was completed (moved to a state mapped as done in the workflow settings). |
Date created | Item creation date (from the Linear API). |
Date updated | Last update date (from the Linear API) |
Due date | Issue Due date. |
Epic | The Epic the issue is assigned to |
Estimate | GitLab issue weight |
GitLab ID | GitLab's autoincrement ID |
Issue or MR ID | Unique identifier of the issue (from the GitLab API). |
Issue or MR name | Name of the issue, task, or merge request. |
Item type | Issue, task, or merge request. |
Iteration | The current iteration of the issue, task, or merge request |
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. |
Milestone | The assigned milestone of the issue, task, or merge request |
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 | GitLab's estimate field in the time tracking feature. |
Project | The prroject the issue, task, or merge request is currently assigned to. |
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) |
Start date | The set start date of the issue |
State | The issue workflow state |
State (open/done) | Whether the issue's mapped state is Open (Not started or In progress) or Done. |
Team | The team the issue is assigned to. |
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. |
Timings | The total time spent in each workflow state. |
Work done | The Spent field from GItLab time tracking feature |
Work left | The remaining estimated time from GitLab time tracking feature. |
Workflow state | The current workflow state of the issue. |
This page describes the available units, metrics, and issue properties when creating a chart for a GitLab data source.
See also these related resources
Chart editor guide
Screenful Knowledge base
Units
Units are the numbers shown in the charts. Unit can be any of these:
Issues and MRs | By default, charts display the count of issues, tasks, and merge requests. |
|---|---|
Hours | GitLab's estimate field in the time tracking feature. |
Points | GitLab issue weight |
Time in state | Timing metrics (reaction, lead, cycle time). These are calculated for all issues, tasks, and merge requests. |
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
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 Linear API). |
Completed (within date range) | Issues by Date completed. The last date & time when the issue was completed (moved to a state 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). |
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) |
Completed on time | Was the item completed before the due date (true/false). |
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 GitLab board the item is currently in. |
Date completed | The last date & time when the issue was completed (moved to a state mapped as done in the workflow settings). |
Date created | Item creation date (from the Linear API). |
Date updated | Last update date (from the Linear API) |
Due date | Issue Due date. |
Epic | The Epic the issue is assigned to |
Estimate | GitLab issue weight |
GitLab ID | GitLab's autoincrement ID |
Issue or MR ID | Unique identifier of the issue (from the GitLab API). |
Issue or MR name | Name of the issue, task, or merge request. |
Item type | Issue, task, or merge request. |
Iteration | The current iteration of the issue, task, or merge request |
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. |
Milestone | The assigned milestone of the issue, task, or merge request |
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 | GitLab's estimate field in the time tracking feature. |
Project | The prroject the issue, task, or merge request is currently assigned to. |
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) |
Start date | The set start date of the issue |
State | The issue workflow state |
State (open/done) | Whether the issue's mapped state is Open (Not started or In progress) or Done. |
Team | The team the issue is assigned to. |
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. |
Timings | The total time spent in each workflow state. |
Work done | The Spent field from GItLab time tracking feature |
Work left | The remaining estimated time from GitLab time tracking feature. |
Workflow state | The current workflow state of the issue. |
This page describes the available units, metrics, and issue properties when creating a chart for a GitLab data source.
See also these related resources
Chart editor guide
Screenful Knowledge base
Units
Units are the numbers shown in the charts. Unit can be any of these:
Issues and MRs | By default, charts display the count of issues, tasks, and merge requests. |
|---|---|
Hours | GitLab's estimate field in the time tracking feature. |
Points | GitLab issue weight |
Time in state | Timing metrics (reaction, lead, cycle time). These are calculated for all issues, tasks, and merge requests. |
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
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 Linear API). |
Completed (within date range) | Issues by Date completed. The last date & time when the issue was completed (moved to a state 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). |
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) |
Completed on time | Was the item completed before the due date (true/false). |
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 GitLab board the item is currently in. |
Date completed | The last date & time when the issue was completed (moved to a state mapped as done in the workflow settings). |
Date created | Item creation date (from the Linear API). |
Date updated | Last update date (from the Linear API) |
Due date | Issue Due date. |
Epic | The Epic the issue is assigned to |
Estimate | GitLab issue weight |
GitLab ID | GitLab's autoincrement ID |
Issue or MR ID | Unique identifier of the issue (from the GitLab API). |
Issue or MR name | Name of the issue, task, or merge request. |
Item type | Issue, task, or merge request. |
Iteration | The current iteration of the issue, task, or merge request |
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. |
Milestone | The assigned milestone of the issue, task, or merge request |
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 | GitLab's estimate field in the time tracking feature. |
Project | The prroject the issue, task, or merge request is currently assigned to. |
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) |
Start date | The set start date of the issue |
State | The issue workflow state |
State (open/done) | Whether the issue's mapped state is Open (Not started or In progress) or Done. |
Team | The team the issue is assigned to. |
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. |
Timings | The total time spent in each workflow state. |
Work done | The Spent field from GItLab time tracking feature |
Work left | The remaining estimated time from GitLab time tracking feature. |
Workflow state | The current workflow state of the issue. |