FAQs on Azure DevOps dashboards, charts, and reports

TFS 2018

Find answers to frequently asked questions when using Azure DevOps dashboards, charts, and reports.

Access and permissions

Who can create and view dashboards?

All members of an Azure DevOps project can view dashboards. Only members with Basic access or greater can create and edit dashboards. For details on managing dashboard permissions, see Set dashboard permissions.

Can I restrict who can view my dashboards?

Yes. From the user interface, you can't set read permissions on a dashboard. However, using permission management command-line tools, you can set more granular permissions, such as Read, Create, and MaterializeDashboard permissions. To learn more, see Security namespace and permission reference.

Can I share a dashboard with a non-project member?

No. Only users who are valid project members can view dashboards. They must sign in to the web portal for a project to view a dashboard.

Are there restrictions on what charts or data project members can view in a dashboard?

Dashboard charts and widgets contain data that is subject to their own permissions and access levels. Project members with Basic access or greater can view dashboard charts and reports if they have the necessary permissions, most of which are granted by default. Members granted Stakeholder access can't view any code-related charts or reports.

In general, if users aren't granted the following permissions, they won't be able to view the data for the corresponding chart or widget:

  • View work items in this node (Area Path permission): Required to view queries and work items displayed in a query or dashboard chart
  • View work items in this node (Area Path permission): Required to view queries and work items displayed in a query or dashboard chart
  • Read (query permission): Required to view query-based charts
  • Read (Git or TFVC repository permission): Required to view code tile charts
  • View build pipeline, View builds (build object-level permissions): Required to view build pipeline data
  • View release pipeline, View releases (release object-level permission): Required to view release pipeline data
  • View test runs (project-level permission): Required to view rest run data

Note

The ability for a project member to view query results from a query or dashboard can be impacted by membership within another group. For example, if a project member belongs to two or more groups—and one of the groups has lesser permissions than the other—then the lesser permissions apply. For example, if the group is a member of a Readers group, which may have View permissions denied, then they wouldn’t be able to view queries with work items where they didn’t have view permissions.

For an overview of default permissions, see Default permissions quick reference.

General features

Can I create a private dashboard?

No. You can only create a dashboard and set permissions on the dashboard. To limit who can view the dashboard, you can use a permission management command-line tool. To learn more, see Security namespace and permission reference.

I added a widget but it isn't displaying any data, what's going on?

For Azure DevOps Server 2019 and later versions, a widget won't display data if the corresponding Azure DevOps service is disabled for a project. Check that the associated service is enabled and refresh the dashboard. To learn how, see Turn a service on or off.

Can I copy a dashboard?

No. This feature is currently available for Azure DevOps Services only at this time. It should be available in later versions of Azure DevOps Server in the future.

Can I create a dashboard template?

No. This isn't a supported feature.

Can I copy a dashboard widget?

Yes. You can copy or add a widget configured on one dashboard to another dashboard. To learn how, see Add widgets to a dashboard.

Can I copy a query chart?

Yes. You can copy a query-based widget from one dashboard to another. To learn how, see Add widgets to a dashboard.

Can I interact with a dashboard widget?

Yes. Most dashboard widgets are interactive. Click within the widget and either a new tab or the current tab will display with more details. The specifics of interaction depend on the widget. For example, here are a few ways you can interact with a dashboard widget:

  • Deployment Status:This widget provides links to the various deployments defined for a release.
  • Query Results: Click a work item to open, update, and save the work item within the dashboard.
  • Query Tile: Click the query tile and the current tab opens to the query referenced by the widget.
  • Release Pipeline Overview: This widget provides links that open to the release pipelines and stages.
  • Sprint overview: Click within the widget and the current tab opens to the team backlog.
  • Team Velocity: Click on a bar within the velocity chart and a tab opens to the query containing the work item IDs for the data referenced by the bar.

Project management and work tracking data

No. All query-based charts require configuration of flat-list queries. To learn more, see Track progress with status and trend query-based charts.

How do I view project dependencies?

The best way to view work item dependencies are to use Delivery Plans as described in Track dependencies. To view dependencies in a dashboard, you can add a query results widget that lists a direct links query.

What charts or widgets support PERT or Gannt charts?

Two project management tools in wide use are Program Evaluation Review Technique (PERT) charts and Gantt charts. PERT charts provide support for calculating the amount of time it will take to realistically finish a project. Horizontal bar charts developed by Henry Gantt provide support for visualizing project schedules. Azure DevOps doesn't provide native support for either PERT or Gantt charts. However, it does provide the following tools and extensions that support visualizing schedules and dependencies:

  • Delivery Plans: A marketplace extension that displays scheduled work items by sprint of selected teams against a calendar view.
  • Dependency Tracker): A marketplace extension that supports planning and managing dependencies across teams, projects, and organizations. It provides filterable views to show all dependencies a team is consuming and producing.
  • Gantt-chart extensions: Marketplace extensions that provide support for visualizing portfolio roadmaps.

Sprint activity

How do I track changes made to a sprint?

There isn't a sprint scope change chart or widget. However, you can query for work items added to a sprint or moved out of a sprint after the start of the sprint. To learn how, see the following sections provided in Implement Scrum practices for your team, Query sprint scope changes:

  • List work items added after the start of the sprint
  • List work items moved out of the sprint

Do sprint burndown or burnup charts reference team capacity settings?

Yes. Team days off and team member capacity are referenced in sprint burndown charts and reports. To learn more about setting team capacity, see Determine and set sprint capacity.

Cross-project data views

How do I view data from several projects in one dashboard?

There are a few ways to view data from several projects in a single dashboard.

  • Query-based widgets: Queries can be defined in any project that target all or select projects. Charts based on these queries can be added to any dashboard. To learn more, see Define a work item query, Query across or within projects.
  • Burndown and Burnup charts: The Burndown and Burnup charts can be configured for any project and team. Therefore, you can add several of these charts to a single chart and configure them to gain a view of progress across several teams and projects.