The Time Tracking features lets you and your team report the amount of time spent working on issues in your project. This feature helps agencies track how much effort has been spent for different clients and lets development teams measure how the actual work compares to their original estimation. With this feature enabled: Your team can add work items to issues. YouTrack calculates the total spent time that is recorded in each issue. You can create summary reports that show total spent time for different types of work. This tutorial shows you how to configure time tracking in YouTrack and use the feature in your project. The first step
is to enable the time tracking feature in your project. Click the name of the project on the Projects page. Click the Edit project link. Select the Time Tracking tab. Select
the Enable time tracking check box. The time tracking feature is
enabled in the selected project. Additional settings for configuring time tracking are displayed. With time tracking, you can estimate how much time you expect to spend to resolve each issue. This estimation is stored as a period type. The amount of time spent that is entered in each work item is also stored as a period type. This field records the total amount of time that is reported for all work items in the issue. You cannot update this value manually — only by adding or editing work items. The amount that is recorded as spent time is compared to the value that is stored in another 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. If your project already includes fields for Estimation and Spent Time that use the period field type, YouTrack uses these fields by default for time tracking. Otherwise, YouTrack automatically adds these fields to your project when you edit these settings. If you need to reconfigure time tracking for an existing project, you can always update these settings on the Time Tracking tab. Customize Work Item AttributesThe next thing you need to decide is what information you want to capture when people report spent time in your project. YouTrack provides a default Work type attribute that lets you assign a work type to each work item. This is typically used to categorize efforts related to different types of activity, like design, development, testing, documentation, and so on. By default, this attribute includes values for Development, Documentation, and Testing. If you want to categorize your work differently, you can add or remove values from the set without affecting other projects in the system. You also have the ability to add an unlimited number of custom attributes to work items in your project. You can add and customize attributes that are used in other projects or define categories that are specifically tailored to the time tracking needs for your project team. The controls for managing these attributes are available from the Time Tracking tab on the Edit project page. An administrator can define work item attributes at the global level on the Time Tracking page under the Administration menu. For more information, see Work Item Attributes. Log Spent TimeYouTrack associates work items with a specific issue. In other words, you can log multiple work items that represent work related to the same issue. In single issue view, YouTrack shows a list of work items that have been added to an issue in the activity stream. The filter that shows spent time is only visible when time tracking is enabled in the project. Users can log time spent working on an issue in minutes, hours, days or weeks. These units of time are referenced with abbreviations such as 1m, 1h, 1d, and 1w. To add a work item to an issue:
To add a work item with a command, just start typing. For example, if you type For issues that are linked as the parent for other issues, YouTrack automatically calculates the spent time as the sum of values that are added to each subtask. If you add work items to a parent task, the spent time in the parent task includes spent time from work items that are added to the parent task plus the total spent time for each of its subtasks. For this reason, we generally recommend that you avoid adding work items to parent tasks. Track Estimations and Spent TimeWhile time spent by different team members can be recorded separately, the value stored in the Spent time field is the total time that is spent working on the issue, regardless of type. To view the Estimation and Spent Time fields on the issue list, make sure that the Show in issue list setting is enabled: This example below shows the total Spent Time of one week and an Estimation of two weeks. The green part of the progress indicator shows that 50% of the estimated time is already spent. The values for the Estimation and Spent Time fields are shown for each issue individually. The Estimation and Spent Time for parent tasks are calculated as the sum of the corresponding values for each subtask.
Report Your EffortsWhen you need to know how much time was spent on different types of activities, create a Time Report. To create a report:
The default presentation for the report is to show work items per issue (as shown in the example above). To view the time report by user, click the per user button on the report page. If you just created the report, you may need to click Refresh after changing the view settings. If you switch the display option to per work item, you see a detailed record for each work item, including comments. If you remove the grouping by work type, you can still view the total time that was spent on different types of activities, such as development, testing, documentation, or graphic design. To see the detailed report, enable the Show work types option next to the controls for switching between different views of the report. To learn more about the settings and display options that are available for this report, see Time Report. Automate Time Tracking with WorkflowsIn YouTrack, a workflow is a set of rules that automate a particular task. A rule is basically a script that YouTrack executes. For more details on workflows, please refer to the Workflow Tutorial. For time management, there are three ready-to-use workflows available in YouTrack:
You can also write your own workflows for advanced time management. If the existing workflows do not reflect your needs, please refer to the Workflow Tutorial. Track Time on an Agile BoardIf you follow an agile development process in your projects, there is a separate tutorial that shows you how to use time management with an agile board in YouTrack. Integrate with a Time Tracking AppMany third-party time tracking applications support integrations with YouTrack. These apps let you track all of your work related activities and not just the time you spend resolving issues. Some apps only let you pull data from YouTrack so you can record include issue tracking as part of your day-to-day work, but many of them will sync your time tracking data so you can report on your spent time in YouTrack as well. For a list of applications that support integrations with YouTrack, see Browser Extensions and App Integrations. Last modified: 21 September 2022 |