About dashboards, charts, reports, & widgets
Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013
Gain visibility into your team's progress by adding one or more widgets or charts to your dashboard. Customizable, highly-configurable dashboards provide you and your teams with the flexibility to share information, monitor progress and trends, and improve your workflow processes. Each team can tailor their dashboards to share information and monitor their progress.
If you're just starting out, read Add, rename, and delete dashboards. If you're looking for instructions on a specific task, in context chart, widget, or report—review Dashboards and widgets quick reference. To learn about our reporting solutions, read Reporting Roadmap.
Important
To view the content available for your platform, make sure that you select the correct version of this article from the version selector which is located above the table of contents. Feature support differs depending on whether you are working from Azure DevOps Services or an on-premises version of Azure DevOps Server, renamed from Team Foundation Server (TFS).
To learn which on-premises version you are using, see What platform/version am I using?
Key concepts
- Dashboards are customizable interactive signboards that provide real-time information. Dashboards are associated with a team or a project and display configurable charts and widgets.
- Charts are query-based status or trend charts derived from a work item query or test results.
- Widgets display configurable information and charts on dashboards. The widget catalog provides brief descriptions of those widgets available to you. In addition, you can add widgets provided through the Azure DevOps Marketplace.
- In-context reports are system-generated charts that support specific services. Examples are team velocity, sprint burndown, and the Cumulative Flow Diagram (CFD), and the Test Failures Report. These reports are displayed on the Analytics tab for a specific service and derive data from Analytics.
- Power BI reports allow users to create rich, customized Power BI reports or other reports using OData queries of Analytics data and the returned JSON data.
- Dashboards are customizable interactive signboards that provide real-time information. Dashboards are associated with a team and display configurable charts and widgets to show information.
- Charts are query-based status or trend charts derived from a work item query or test results.
- In-context reports are system-generated charts that support specific services. Examples are team velocity, sprint burndown, and the Cumulative Flow Diagram (CFD), and the Test Failures Report. These reports are displayed on the Analytics tab for a specific service and derive data from Analytics.
- Widgets display configurable information and charts on dashboards. The widget catalog provides brief descriptions of those widgets available to you. In addition, you can add widgets provided through the Azure DevOps Marketplace.
- Reports
- Power BI reports: For project collections that support the Inherited process, allow users to create rich, customized Power BI reports or other reports using OData queries of Analytics data and the returned JSON data.
- SQL Server reports: For project collections that support the On-premises XML process model, allow users access to out-of-the-box SQL Server reports as well as support to create customized SQL Reports or Excel reports. This requires that the project is configured to support SQL Server reporting.
- Dashboards are customizable interactive signboards that provide real-time information. Dashboards are associated with a team and display configurable charts and widgets to show information.
- Charts are query-based status or trend charts derived from a work item query or test results.
- In-context reports are system-generated charts that support specific services. Examples are team velocity, sprint burndown, and the Cumulative Flow Diagram (CFD), and the Test Failures Report.
- Widgets display configurable information and charts on dashboards. The widget catalog provides brief descriptions of those widgets available to you. In addition, you can add widgets provided through the Azure DevOps Marketplace.
- Reports
- Power BI reports: For project collections that support the Inherited process, allow users to create rich, customized Power BI reports or other reports using OData queries of Analytics data and the returned JSON data.
- SQL Server reports: For project collections that support the On-premises XML process model, allow users access to out-of-the-box SQL Server reports as well as support to create customized SQL Reports or Excel reports. This requires that the project is configured to support SQL Server reporting.
- Dashboards are customizable interactive signboards that provide real-time information. Dashboards are associated with a team and display configurable charts and widgets to show information.
- Charts are query-based status or trend charts derived from a work item query or test results.
- Widgets display configurable information and charts on dashboards. The widget catalog provides brief descriptions of those widgets available to you. In addition, you can add widgets provided through the Azure DevOps Marketplace.
- In-context reports** are system-generated charts that support specific services. Examples are team velocity, sprint burndown, and the Cumulative Flow Diagram (CFD).
- Reports correspond to out-of-the-box SQL Server reports as well as support to create customized SQL Reports or Excel reports. This requires that the project is configured to support SQL Server reporting.
- Dashboards are customizable interactive signboards that provide real-time information. Dashboards are associated with a team and display configurable charts that you pin to the dashboard.
- Charts are query-based status or trend charts derived from a work item query or test results.
- In-context reports are system-generated charts that support specific services. Examples are team velocity, sprint burndown, and the Cumulative Flow Diagram (CFD).
- Reports correspond to out-of-the-box SQL Server reports as well as support to create customized SQL Reports or Excel reports. This requires that the project is configured to support SQL Server reporting.
Configurable dashboards
With dashboards, you can configure an array of charts and widgets.
Each team can add and configure multiple dashboards to share information, view status, progress, and trends, and access quick links and other functions. Easily add and rearrange widgets on the dashboard to show recent changes made to view build status, bug trends, and more.
Sequence for adding and customizing a dashboard
Click a box below to open the corresponding article.
Charts: Work tracking status and trends
With flat-list queries, you can create various charts to monitor status, progress, and trends. To get started, you can open a shared query and create a chart based on your tracking interests. Chart types include status—pie, bar, column, stacked bar, and pivot—and trend—stacked area, line, and area—charts.
Sample Agile tool light-weight charts
Sequence for adding query-based charts to a dashboard
Click a box below to open the corresponding article.
Prior to monitoring work progress and trends, you'll need to have planned your project and made progress on work you're tracking.
Charts: Manual testing progress, results, and trends
The steps to creating charts that track manual testing progress and results are similar to those for tracking work. The starting point, however, begins with the test plan rather than a query. For example, you can find out how many test cases are ready to run, or how many tests are passing and failing in each test suite.
Sample light-weight test charts
And, just like work item query-based charts, you can add these charts to a dashboard.
Sequence for adding test progress and result charts to a dashboard
Widgets
You add widgets to a dashboard to display a chart, information, or set of links. Most widgets are configurable. For a description of each supported widget for your platform and version, see the Widget catalog. Here are the widgets that support the indicated service.
| Boards |
Repos
Pipelines
Test Plans
|
Informational |
Boards
|
Repos
Pipelines
|
Informational |
| Work | Code Build & Release Test | Informational |
| Work |
Code
Build
|
Other
|
Sprint chart widgets
Sample Cumulative Flow Diagram widget
Monitor code activity, build progress and deployment status
With the code tile widgets, you can monitor the activity occurring within a repo or branch folder. Build history displays a histogram of all builds run for a specific build pipeline. Bar color indicates: green-completed, red-failed, and yellow-completed without tests.
Code, build, and release chart widgets
Analytics widgets
Analytics widgets provide rich data based on the Analytics data. Analytics is available to all organizations using Azure DevOps Services.
Sample Lead time widget
To learn more, see the following articles:
Analytics and Analytics widgets
Analytics is in preview for Azure DevOps Server 2019.
Sample Lead time widget
To learn more, see the following articles:
Marketplace widgets
In addition to the widgets available to your from the widget catalog, you may find additional widgets of interest from the Marketplace.
Or, you can create your own widget using the REST API.
In-context reports: Work tracking
Azure Boards provides several in-context reports that derive from Analytics data. From your backlog or board, you can view the Cumulative Flow Diagram and team Velocity reports by selecting the Analytics tab. Each report provides interactive controls to provide each user the view of interest to them. From a Sprint backlog, you can view the sprint burndown trend.
Cumulative Flow Diagram
Use the interactive controls to choose the time frame, swimlanes, and workflow states or Kanban board columns.
Velocity
Use the interactive controls to choose the count or sum field and number of iterations.
Sprint Burndown Trend
Use the interactive controls to choose the start and end of the sprint and count or sum field to use in the burndown. If you don't track Remaining Work in tasks, you can view burndown based on a count of work items/tasks.
Azure Boards provides several in-context reports that derive from the work tracking data store. From your backlog or board, you can view the Cumulative Flow Diagram and team Velocity reports by choosing the minature charts that appear on each page. From a Sprint backlog, you can view the sprint burndown.
Cumulative Flow Diagram
The CFD report shows the count of work items in the backlog based on their state over time.
Velocity
Velocity is based on the values entered for Effort, Story Points, or Size fields for work items that belong to the Requirement Category.
Sprint burndown
Each sprint provides access to two charts. The first tracks capacity for the team, team activities—such as Development, Test, Design—and individual team members. The second tracks the sprint burndown in terms of remaining work.
| Capacity bars | Burndown |
|---|---|
 |
 |
Note
You can add the in-context reports to a dashboard using the copy to dashboard option from the report's context menu.
Note
You can't add the in-context reports to a dashboard. However, you may find a comparable widget listed in the widget catalog that tracks the same or similar data which you can add to the dashboard.
To learn more about these reports, see one of the following articles:
In-context reports: Pipeline Failures and Test Failures
Several in-context reports are provided for Azure Pipelines. These reports derive from Analytics data. Open a pipeline (or release summary for Test failure) to view the reports and select the Analytics tab. The summarized cards are present for all reports. You can click on the cards for a detailed report.
In-context reports: Pipeline Test Failures
Azure Pipelines provides an in-context Test failures report, derived from Analytics data. Open a release summary to view the report and select the Analytics tab. Select the summarized card for a detailed report.
Pipeline pass rate report
The Pipeline pass rate report provides a trend of pipeline failure and task failure of the pipeline. You can view the pass rate of the pipeline over a configurable period of time (7/14/30 days). You can view additional details in Task failure details, which not only highlights the trend, but also list the top failing tasks.
Learn more about the Pipeline pass rate report.
Test failures report
The Test failures report provides a granular view of the top failing tests in the pipeline, along with the failure details. Summary charts are also provided for builds that indicate code coverage and test failures or success.
Learn more about the Test failures report.
Pipeline duration report
The Pipeline duration report provides the duration trend of a pipeline. It also highlights the average run time of the total successful runs over a period of time (7/14/30 days) and provides insights on the tasks which have impacted the duration of the pipeline.
Learn more about the Pipeline duration report.
Try this next
Add custom work tracking fields
You can add data to support reporting requirements by adding a custom field.
You can add data to support reporting requirements by adding a custom field Inheritance process or On-premises XML process.
You can add data to support reporting requirements by adding a custom field.
Extensibility
Using the REST API service, you can create a custom widget.