Skip to main content

Measure cycle time in working hours

Show on every work item how much working time it took from starting work to finishing it, and find the slow ones on a dashboard.

Problem: Jira shows when work was created and resolved, but not how long the team worked on it. Nights, weekends and holidays make every duration look longer.

Solution: You set up a work calendar with your team's hours. Then you create a Cycle time field from a recipe, fill in older work items, and color the value with a traffic light.

What you'll need​

  • FieldCraft, installed, with an active license.

  • The Administer Jira global permission, to create the calendar and the field.

  • Workflows with statuses in the In Progress and Done categories. The recipe uses the status categories, so it works on every workflow.

  • Your team's working hours, time zone and public holidays.

What your team will experience​

  1. A developer moves a story to Done. Cycle time shows the working time it took, such as 2d 4h, in green, amber or red.

  2. A scrum master opens the team dashboard and sees the slowest finished work at the top.

  3. An engineering manager searches for "Cycle time" > 5 to review work that took more than five working days.

Set it up​

1. Create a work calendar​

  1. Go to Settings (βš™) > Marketplace apps > FieldCraft: Custom Fields. The FieldCraft admin page opens.

  2. On the Settings tab, select Work calendars, then Create work calendar. The calendar form opens.

  3. Enter a Name, and select the Time zone your team works in.

  4. Set the from: and to: times for each working day. Clear both times on days off.

  5. Under Holidays, add your public holidays, and select Save.

    The work calendar form for 8/5, Mon-Fri, 09:00 - 17:00 with its name, time zone, working hours from 09:00 to 17:00 on weekdays and Add break buttons

2. Create the field​

  1. On the Fields tab, select New field from recipe. The recipe gallery opens.

  2. Select Cycle time. The recipe form opens.

  3. Under Working hours, select your calendar.

  4. Under Check it on a real work item, enter the key of a finished work item, and select Run preview. The preview shows the value and saves nothing.

    The Cycle time recipe with the 8/5, Mon-Fri, 09:00 - 17:00 work calendar and a preview of 22 days on a work item

  5. Optional: under Show it on screens, select the screens your teams use.

  6. Select Create field. A page opens that says Cycle time is ready.

3. Fill in older work items​

  1. Under Fill in existing work items, select Fill last 90 days.

FieldCraft fills in work items created in the last 90 days or still open. It runs in the background, so you can close the page.

4. Add a traffic light​

  1. On the Fields tab, open the β€’β€’β€’ menu of Cycle time, and select Edit configuration. The field's configuration page opens.

  2. Under Display, select Traffic light: green, amber or red by two thresholds.

  3. Keep Lower is better, 3 in Amber from and 5 in Red from, and select Save.

    The Display section with Traffic light selected, Lower is better, Amber from 3, Red from 5 and the preview under 3: green, 3 to 5: amber, 5 working days and more: red

Result: Values under 3 working days show green, 3 to 5 amber, and 5 or more red.

5. Build a filter and a dashboard​

  1. In Jira's search, run this JQL:

    "Cycle time" IS NOT EMPTY AND resolved >= -30d ORDER BY "Cycle time" DESC
  2. Save the filter, for example as Cycle time, last 30 days.

  3. On your team's dashboard, add a Filter results gadget for the filter, and show the Cycle time column.

The gadget lists the slowest work first, with the traffic light before each value.

Check that it works​

  1. Move a test work item to an In Progress status, and later to a Done status.

  2. Open the work item. Confirm that Cycle time shows the working time in between.

  3. Hover over the value. Confirm that it names your calendar.

  4. Reopen the work item. Confirm that the field is empty until it's done again.