Duration Between Statuses Report Metrics
The Duration Between Statuses report makes it possible to define time metrics that will run between two points in an issue’s lifecycle.
The Metrics button will be shown only when the Duration Between Statuses report type is selected. This button opens a panel that allows you to define one or more metrics that will be used for the Duration Between Statuses report.
Metric Definitions
Name
The Name will be used as the column header for the metric.
Start At
Start At marks where the metric will start counting and has three options.
“Issue Creation” means the metric’s starting point is the moment the issue was created.
“Statuses” means the metric starts with the transition to a status. Select one or more statuses and the metric starts when the issue enters any one of the selected statuses. If your workflow allows issues to visit the same status more than once, the “First transition to / Last transition to” selection allows you to start the metric at the First or Last visit to a status. (If an issue visits a status only once, selecting first or last won't make a difference.)
Selecting a “Date field” starts the metric on the date specified in the selected date field of the issue. This makes it possible to set a different start date for each issue. This is particularly useful when the start condition is not pre-defined but is negotiated between stakeholders.
Stop At
Stop At marks where the metric will stop counting and has two options.
“Statuses” means the metric stops with the transition to a status. Select one or more statuses and the metric stops when the issue enters any one of the selected statuses. If your workflow allows issues to visit the same status more than once, the “First transition to / Last transition to” selection allows you to stop the metric at the First or Last visit to a status. (If an issue visits a status only once, selecting first or last won't make a difference.)
Selecting a “Date field” stops the metric on the date specified in the selected date field of the issue. This makes it possible to set a different stop date for each issue. This is particularly useful when the completion condition is not pre-defined but is negotiated between stakeholders.
Pause on
Pause on selects where the metric will temporarily stop counting and only works with statuses.
You can leave this one empty or select multiple statuses here. The metric will pause counting on these statuses and will resume counting when the issue exits these statuses.
Metric States
When these metrics are displayed in the report, there are four possible metric states:
Not Started
These are the metrics that haven’t reached the starting status yet. For these metrics, the report displays no values.
Running (
)
These are the metrics that have reached the starting status but haven’t reached the stop status yet. For these metrics, a value is displayed in the report, and next to the value, a running man icon is displayed to indicate that the metric is still counting. For any running metrics, the time is measured up to the moment the report is run and will change each time the report is refreshed.
Paused (
)
These are the metrics that reached the starting status, haven’t reached the stop status yet, but are in one of the “pause” statuses. The metric hasn’t stopped, but also is not counting at the moment. For these metrics, a value is displayed in the report, and next to the value, a pause icon is displayed to indicate that the metric is paused.
Completed
These are the metrics that visited the starting status and then reached the stop status. For these metrics, a value is displayed in the report with no icons next to it.