Configure and monitor sprint burndown

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Throughout your sprint, you can monitor the sprint burndown report to determine if your team is on track to complete its sprint plan. There are two sprint accessible burndown charts: the in-context Burndown Trend report viewable from a team sprint backlog and the Sprint Burndown widget that you can add to a dashboard.

Both the report and the widget derive data from Analytics. They support monitoring burndown based on a count of work items or a sum of Story Points/Size/Effort, Remaining Work, or other numeric field.

You can add either the report or widget to a dashboard. Also, you can monitor progress using the Analytics-based burndown or burnup widgets. They provide more configuration options.

Throughout your sprint, you can monitor the sprint burndown report to determine if your team is on track to complete its sprint plan. The in-context sprint burndown report supports tracking burndown based on Remaining Work assigned to sprint tasks. If you don't track tasks or Remaining Work, then you can use the Analytics-based burndown and burnup widgets. They provide more configuration options.

Important

  • Deleting Area Paths or reconfiguring Iteration Paths causes irreversible data loss. For example, burndown and burnup widget charts, sprint burndown, and velocity charts for teams with changed Area Paths won't display accurate data. Historical trend charts reference the Area Path and Iteration Path as they were defined at the time for each work item. Once deleted, you can't retrieve historical data for these paths.
  • You can only delete area and iteration paths that are no longer used by any work items.

Use this article to learn about:

  • Metrics tracked in the sprint burndown report and widget
  • Team activities required to track tasks and Remaining Work
  • How to set interactive controls to personalize your view of the sprint burndown report
  • How to add the in-context Burndown Trend report to a dashboard
  • How to configure the Sprint Burndown widgets
  • How to view current and past sprint burndowns

For an overview of all burndown and burnup charts available to you, see Burndown and burnup guidance.

  • Metrics tracked in the sprint burndown report and widget
  • Team activities required to track tasks and Remaining Work
  • How to configure the Sprint Burndown widget
  • How to view current and past sprint burndowns

Note

Sprint burndown reports are derived from data tracked by a team during a sprint or iteration. For more information, see About teams and Agile tools.

The in-context Burndown Trend report

The Burndown Trend report is based on either a count of tasks or remaining work estimates, or other numeric fields that you define and update throughout the sprint cycle. For details, see Sprint planning. To open this report, see Open a Sprint backlog.

A healthy sprint burndown report looks something like the image shown here. The blue area indicates the number of work items active or in progress each day of the sprint. As shown in this example, one work item is still active at the end of the sprint.

Screenshot shows the burndown trend for specified start and end dates.

Element Description
Date range The start and end date of the sprint.
Stories Remaining The number of stories remaining in the sprint. If you choose a different work item type, the remaining number of those work items is shown.
Completed The percentage of work completed based on original scope. Select Completed to see the full list of completed work items.
Average burndown Average work completed.
Total Scope Increase Shows the change in how much work from the original scope since the burndown started. The example shows that six work items were removed.
Remaining The number of work items active or in progress. The example shows one active item is remaining in the sprint.
Total Scope The total number of work items in the sprint including closed work items. If the team's default iteration is the @CurrentIteration, then new work items are added to the current iteration. The scope decreases as the Iteration Path is modified to another sprint, or work items are completed.
Ideal Trend The ideal burndown rate for the sprint calculated from the number of work items, days in the sprint, and number of working days.

Because individual team members might only update their work items once a week or every few days, there's usually a stair-case burndown pattern.

The in-context sprint burndown report is based on the tasks and Remaining Work estimates that you define and update throughout the sprint cycle. For details, see Sprint planning and taskboard. To open the sprint burndown chart, see Open sprint burndown chart.

A healthy sprint burndown chart looks something like this. The Ideal Trend line connects the two points:

  • (1) Team's total capacity at the start of the sprint.
  • (2) 0 Remaining Work at the end of the sprint.

The slope represents the rate at which the team needs to burn down work to finish the sprint on time.

The actual graph, the blue area, represents the total amount of planned sprint work and how it changes throughout the course of the sprint. The blue area corresponds to the sum of all Remaining Work set for all sprint tasks, and possibly bugs, that have the current sprint as their iteration path.

Screenshot of a healthy sprint burndown chart.

The Sprint Burndown widget

In the widget catalog, you find two versions of the Sprint Burndown widget: the Analytics-based Sprint Burndown and Sprint Burndown (Legacy), which is built from the work tracking data store.

Sprint Burndown widget

The Analytics-based Sprint Burndown widget provides an easy way to monitor progress for a team by showing work remaining for a given sprint. Work remaining is the vertical axis and time is the horizontal axis. You can define remaining work based on Stories or Tasks, and by counting the work items or summing a field.

Screenshot shows the Sprint Burndown widget, which displays a graph of the burndown.

Element Description
Date range The start and end date of the sprint.
Tasks Remaining The number of tasks remaining in the sprint. If you choose a different work item type, the remaining number of those work items is shown.
Completed The percentage of work completed based on original scope. Select Completed to see the full list of completed work items.
Average burndown Average work completed.
Total Scope Increase Shows the change in how much work from the original scope since the burndown started. The example shows that four work items were added to the sprint.
Remaining The number of work items active or in progress. The example shows 15 active items are remaining in the sprint.
Total Scope The total number of work items in the sprint including closed work items. If the team's default iteration is the @CurrentIteration, then new work items are added to the current iteration. The scope decreases as the Iteration Path is modified to another sprint, or work items are completed.
Ideal Trend The ideal burndown rate for the sprint calculated from the number of work items, days in the sprint, and number of working days.

The charts provide useful metrics to help you answer the question: Are we on track to complete this set of work by the end a sprint?

  • Percentage work complete
  • Number of work items not estimated, if using a field other than Remaining Work
  • Average burndown
  • Total scope increase

Sprint Burndown (Legacy) widget

The Sprint Burndown (Legacy) widget adds a chart based on Remaining Work defined for tasks in a team's current sprint. Select this version when you don't have access to Analytics. Configuration options include team selection, and widget size.

Screenshot shows the Sprint Burndown Legacy widget, which shows a burndown chart.

If your dashboard already has a legacy version available, you can easily upgrade the widget by editing the widget's configuration, and checking Try the new version now. You can always go back to the legacy version by unchecking the box.

The Sprint Burndown widget adds a chart based on Remaining Work defined for tasks in the team's current sprint. There are no configuration options for this widget.

Screenshot shows the Sprint Burndown Legacy widget configuration dialog.

Prerequisites

  • Access:
    • Be a member of a project with at least Basic access.
    • To add a widget to a team dashboard, be a member of the team.
  • Permissions: Be a team administrator or project administrator, or have specific dashboard permissions granted to you.
  • Feature enablement: Have Boards enabled. If disabled, none of the work tracking Analytics widgets display. To re-enable it, see Turn a service on or off.
  • Task awareness: Be aware of the required and recommended tasks, listed later in this article.

Team activities to track tasks and Remaining Work

To monitor sprint burndown, your team must schedule sprints and assign work to those sprints.

If you want to monitor sprint burndown based on tasks and Remaining Work, your team must carry out these extra actions.

To monitor sprint burndown, your team must schedule sprints and assign work to those sprints. For sprint burndown charts to show meaningful data, your team must carry out these extra actions.

Required activities

  • Define and estimate tasks for each product backlog item that you're working on in the sprint. If you work from your team's backlog and taskboard, the items you create are automatically assigned to the current sprint (Iteration) and to your team's default Area Path. For more information, see Add tasks to backlog items to support sprint planning.
  • Update Remaining Work for each sprint task as work progresses. For more information, see Update tasks during the sprint cycle.
  • To decrease the effect of poor estimates, define tasks that take a day or less to complete.
  • Don't divide tasks into subtasks. If you divide a task into subtasks, specify hours only for the subtasks. These hours are rolled up as summary values for the parent task.
  • To support monitoring and achieve a smoother burndown chart, update Remaining Work daily or several times within a week.
  • At the end of the sprint, update the task status of completed tasks and determine how to handle incomplete tasks.

Empty sprint burndown chart

If your sprint burndown chart appears empty, check these points:

  • Did you assign tasks to the sprint associated with the chart?
  • Did you assign Remaining Work to the tasks assigned to the sprint?
  • Are the parent work items of the tasks assigned to the same sprint? If not, the tasks might appear in another sprint associated with the parent item.

Open a Sprint backlog

You view the in-context sprint burndown report from a team's Sprint backlog.

  1. From your web portal, open your team's sprint backlog.

    1. Check that you selected the right project.
    2. Select Boards>Sprints and select the correct team from the team selector menu.
    3. Select Backlog.

    Screenshot shows where you can select Backlog in Azure Boards.

    To select another team, open the selector and select a different team or select the View Sprint directory option. Or, you can enter a keyword in the search box to filter the list of team backlogs for the project.

    Screenshot shows the option to select another team in Azure Boards.

  2. To select a different sprint than the one shown, open the sprint selector and select the sprint you want.

    Screenshot shows the option to select another sprint in Azure Boards.

    The system lists only those sprints that are selected for the current team focus. If you don't see the sprints you want listed, select New Sprint from the menu, and then select Select existing iteration. For details, see Define iteration paths.

  1. From your web browser, open your team's sprint backlog.

    1. Check that you selected the right project.
    2. Select Boards>Sprints and select the correct team from the team selector menu.
    3. Select Backlog.

    Screenshot shows where you can select Backlog in Azure Boards.

    To select another team, open the selector and select a different team or select the Browse all sprints option. Or, you can enter a keyword in the search box to filter the list of team backlogs for the project.

    SScreenshot shows the option to select another team in Azure Boards 2019.

  2. To select a different sprint than the one shown, open the sprint selector and select the sprint you want.

    Screenshot shows the option to select another sprint in Azure Boards 2019.

    The system lists only those sprints that are selected for the current team focus. If you don't see the sprints you want listed, then select New Sprint from the menu, and then select Select existing iteration. For details, see Define iteration paths.

View the in-context Burndown Trend report

  1. To open the Sprint burndown report, select Analytics.

    Screenshot shows the Azure DevOps Analytics tab for sprints.

  2. Use the interactive controls to select from the following options:

    1. The Start Date and End Date of the sprint. These dates default to the team's current iteration sprint dates.
    2. The Backlogs/Work Items to burn down on, either the product backlog (Stories, Issues, Product Backlog Items, or Requirements) or Tasks backlog to use. Your selection impacts the options available for the Burndown on menu.
    3. The Burndown on field to use to calculate burndown, either a Count of Work Items or a sum of a field, such as Story Points, Effort, or Size.
    4. Check or uncheck Show non-working days. Nonworking days appear as gray bars in the background when enabled. Default nonworking days are set for a team and for a team's sprint through the capacity page. For more information, see Set sprint capacity.

    Select Reset to reset the controls to the default options. By default, the dates are set to the selected sprint. Changes to the start and end dates don't change any sprint date definitions.

  3. If you don't track Remaining Work in tasks, you can view burndown based on a count of work items or tasks. To show a summary of the data for a specific day, hover over any point on the chart.

When you choose to view the Tasks backlog and Sum of Remaining Work, the blue area shows the sum of Remaining Work per day for those tasks that are still active or in progress. As the Remaining Work is updated, the chart indicates the rate of burndown. The Scope trend line indicates the addition of Remaining Work after the start of the sprint. The Ideal trend line indicates the ideal burndown rate for the sprint. Capacity lines are only shown when the team configured capacity.

Screenshot shows Burndown trend based on Remaining Work.

Note

The options for the sum fields depend on the numeric fields defined for task and requirement category work item types. The most common fields used to show the burndown trend are:

The selections you make are only set for you, and persist across sessions until you change them.

Screenshot shows how to open sprint burndown chart for Azure DevOps 2019.

Add the report to a dashboard

  1. To add the report to a dashboard, select the actions icon and select Copy to Dashboard.

    Screenshot shows the Analytics in-context report, Copy to dashboard option.

  2. Select the dashboard and select OK.

Add the Sprint Burndown widget to a dashboard

You can add the Sprint Burndown widget to a dashboard and select the team whose progress you want to monitor. You configure these widgets for one or more teams.

  1. If you need to add the Sprint Burndown widget to your dashboard, do that now.

    You can filter the Add Widget dialog with sprint burndown to quickly locate the two widgets available to you.

    Screenshot shows the Add Widget dialog, filter by sprint burndown.

  2. To configure the widget, select the actions icon and then select Configure.

    Screenshot shows the Configure menu item.

  1. Select Edit to add the Sprint burndown widget to your team dashboard.

    The widget catalog automatically opens. Drag the Sprint Burndown widget onto the dashboard.

  2. When you finish your additions, select Done Editing.

    The sprint burndown chart for the team's current sprint is added to the dashboard. There's no configuration option associated with this widget.

    Screenshot shows the Sprint Burndown Legacy widget.

Configure the Analytics-based Sprint Burndown widget

  1. To configure the widget, select the actions icon and select the Configure option.

    Screenshot shows the Sprint Burndown widget Configuration dialog.

  2. Modify the Title of the widget and select your preferred Size. The Sprint Burndown widget can scale up to 10x10.

  3. Make the following selections:

    • Team: Select the Team you want to track.
    • Backlogs and work items: Select the work items to include in your burndown. You can select to any backlog or a specific work item type.
    • Burndown on: Choose how you want to burndown. You might burndown by count of work items or a sum based on a selected field.
    • Select iteration: You can select @CurrentIteration, or a specific iteration.
    • Time period: If you selected @CurrentIteration, these dates aren't editable. They're automatically the start and end date of the current iteration. If you selected a specific iteration, you can customize the start/end date for the burndown chart.
  4. Advanced features: Select the following options that you want to add to your chart.

    • Show total scope: Displays both the historical and projected scope increase.
    • Show non working days: Displays nonworking days on the burndown. When displayed, nonworking days are shaded.
    • Plot remaining using work item type color: Displays remaining work based on the work item type color, rather than the default blue color. If multiple work items are included, then it stacks colors by work item type.

Configure the Sprint Burndown (Legacy) widget

To configure the widget, select the actions icon and select the Configure option.

Screenshot shows the Sprint Burndown Legacy widget configuration dialog.

If your dashboard already has a legacy version available, you can easily upgrade the widget by editing the widget's configuration. Select Try the new version now. You can always go back to the legacy version by unselecting the option.

Current and past sprint burndown charts

As you complete each sprint, the system maintains a history of your activity.

To view a past sprint and its burndown chart, select the sprint from the Sprint selector.

Screenshot shows here you can select a past sprint from the sprint selector.

You can review sprint burndown in-context reports to show the team patterns in execution. The burndown charts maintain a record of the team's ability to plan and estimate.

Sprint 1 Sprint 2 Sprint 3
Screenshot shows the chart for Sprint 1. Screenshot shows the chart for Sprint 2. Screenshot shows the chart for Sprint 3.

Teams can find it useful to review these reports periodically during their sprint retrospectives. It can spark useful discussions and lead to setting one or more sprint goals, such as:

  • How does your projected velocity match up to your actual velocity?
  • How can you more accurately determine how much your team can accomplish in a sprint?
  • How can you complete work at a more regular pace throughout the sprint?