YouTrack Standalone 2017.1 Help

Agile Boards with Time Tracking

YouTrack lets you enter estimates for the amount of effort required to finish a task or develop a feature. In Scrum development, these estimates are commonly recorded in relative units that let teams measure the relative complexity of a task.

Some teams choose a different approach and estimate their efforts in intervals of real time. By logging the amount of time spent working on each issue, the team can measure how the actual work compares to their original estimation.

When you enable the Time Tracking feature, you can update and track these values on an agile board. This feature has its advantages no matter which type of agile practice you follow.

  • On a Scrum board, the estimations and spent time can be used to calculate the burndown for each sprint.
  • On a Kanban board, the total estimation and spent time show you how much work is currently allocated to each stage of development.

Time tracking is often used by agencies to monitor the amount of work performed for different clients. You can create separate agile boards and track spent time independently for each project or use dedicated swimlanes for different clients and track all of your work on a single board.

This tutorial shows you how to set up and use the Time Tracking feature on an agile board.

Configure Your Projects

Before you can use the Time Tracking feature on an agile board, you must enable and configure the feature in each of the projects that are managed on the board. If you manage multiple projects on one agile board, all of the projects must use the same fields to store estimations and spent time.

To enable time tracking in a project:

  1. Click the Projects link in the header.
  2. Select the project where you want to enable time tracking.
  3. Click Edit project link.
  4. Select the Time Tracking tab.
  5. Select the Enable time tracking checkbox.
  6. Select fields that use a period type to store estimations and spent time.
    /help/img/youtrack/2017.1/abttEnabledProjectTimeTracking.png

For more information about tracking time in your projects, see Time Tracking Tutorial.

Configure Your Agile Board

The next step is to configure your agile board to display time tracking data. When configured, the board displays progress indicators for each column, swimlane, and card. You and your team can also update estimations directly on the board.

If you are using a Scrum board and want to track the progress for each sprint on a burndown chart, you can configure the board to calculate the burndown by spent time. For more information, see .

To configure time tracking on the agile board:

  1. Open the agile board and click the Board settings (/help/img/youtrack/2017.1/icon-Cog.png) button.
  2. Select the Card tab.
  3. In the Estimation field drop-down, select the field that you use to store estimations for the time tracking feature in your projects.
    /help/img/youtrack/2017.1/abttBoardCardTimeTracking.png
  4. (Optional) Select the Chart tab.
  5. For Burndown calculated by, enable the Work items option.
    /help/img/youtrack/2017.1/abttCalculateBurndown.png

Track Estimation and Spent Time on the Board

Time tracking data is displayed in a progress indicator. Each progress indicator compares the spent time to the estimation.

  • The amount of spent time that does not exceed the original estimation is drawn in green. The missing piece of the pie represents the amount of time that is left over. The time left and estimation are displayed in a tooltip when you move the pointer over the progress indicator.
  • When the spent time exceeds the original estimation, the progress indicator is drawn as a red circle. The tooltip displays the amount of spent time that exceeds the original estimation.

The estimation for each task is displayed as a progress indicator on the cards on the board. The total estimation for all cards in a column is displayed in the column header.

/help/img/youtrack/2017.1/abttEstimationOnBoard.png

If you use swimlanes, the agile board shows also the total estimation for all cards in each swimlane. The total estimation for all of the tasks on the board is shown next to the sprint countdown in the toolbar.

Update Time Tracking Data

If you want to change the estimation value for an issue, you can update this field directly on the board. Click the Estimation link on a card and update the value in the dialog.

/help/img/youtrack/2017.1/abttUpdateEstimation.png

Spent time cannot be updated manually — only by adding or editing work items. You can add work items to issue on the board with a command. For more information, see Add Work Items.

For issues that are linked as the parent for other issues, YouTrack automatically calculates the estimation and spent time as the sum of values that are added to each subtask. If you created a project with the Scrum Project Template, pay careful attention when updating time tracking data. This project template creates two agile boards: one for development and another for project management.

  • The project management board tracks epics and user stories.
  • The project development board tracks user stories and tasks.

With this setup, you should only enter estimations and add work items to issues that are assigned the Task type. The estimation and spent time for each user story is calculated automatically based on the values that are assigned to each of its subtasks. Similarly, the estimation and spent time for each epic is calculated based on the calculated values that are assigned to its subtasks, the user stories.

If you enter an estimation value for an epic or user story, the automatic synchronization is broken and no longer reflects the estimation values that are assigned to each task. To restore the synchronization and calculate the estimation for the parent task automatically, set the estimation value in the parent task to the total estimation for each of of its subtasks.

Use the Burndown Chart

If you are not familiar with the basic concept behind the burndown chart, see Burndown Chart.

With time tracking enabled, you can calculate the burndown based on the spent time that is logged in each issue.

To calculate the burndown based on time spent:

  1. Open the agile board and click the Board settings (/help/img/youtrack/2017.1/icon-Cog.png) button.
  2. (Optional) Select the Chart tab.
  3. For Burndown calculated by, enable the Work items option.
    Calculate Burndown Settings

Use the burndown chart to monitor your progress during the sprint.

/help/img/youtrack/2017.1/burnDownWithOverDue.png

The burndown chart represents time tracking values on the line graph as follows:

ValueDescription
Ideal BurndownThe first value at the beginning of the timeline is the the total estimation value for the selected period. The line is drawn to the end of the timeline where the unfinished estimation is zero. Each point along the graph represents the amount of estimated time that is expected to be unspent each day in order to finish all tasks by the end of the selected period. The ideal burndown is not calculated for non-working days, which are represented by flat lines.
Remaining EffortShows the actual unspent estimation in the issues that remain in an unresolved state for each day. This value is reduced by the total estimation for each issue that moves to a resolved state on that day.
Ahead of/Behind ScheduleDisplays the difference between the ideal burndown and the remaining effort. If the remaining effort is greater than the ideal burndown, the value is shown as behind schedule. If the ideal burndown is greater than the remaining effort, the value is shown as ahead of schedule.
Spent TimeShows the cumulative amount of spent time for each day. This value is calculated based on the amount of spent time that is added to issues in work items.

The burndown chart only calculates spent time that is added as work items to the issues that are shown on the report. If you set up an agile board for epics as described in Agile Boards for Epics, the burndown chart for user stories doesn't show spent time. This is because the spent time for each user story is calculated based on the work items added to its underlying tasks. The user stories themselves don't have any work items.

If you want to show spent time on a burndown chart for parent tasks, you need to add your work items to these issues instead of using time tracking for subtasks. You can add work items to both parent tasks and subtasks, but the spent time calculation for parent tasks is inflated.

Overdue EffortDisplays the amount of remaining effort at the end of the sprint.
Last modified: 18 April 2017