Viewing and managing dashboards
You can monitor key metrics of your project, identify risks and communicate progress using configurable dashboards.
This feature is in beta and is available in the Enterprise plan. We are rolling out this feature in phases with a rollout completion date expected by early December. See the Community post for additional details.
Retrieving dashboards
To retrieve Dashboards:
Retrieve your project. See Retrieving projects for more information.
Select Main Branch from the left side menu.
Click Dashboards from the top menu. The drop-down menu provides shortcuts to the Project health dashboard, a built-in dashboard, and All dashboards page which includes your custom dashboards.
Permissions
Private project:
Browse permission is required to view, create and edit project dashboards.
Public projects:
Anyone can view project dashboards, including any custom dashboards.
Members of the organization that the project belongs to can edit and create project dashboards.
A list of all dashboards
The All dashboards page shows a list of dashboards for your project.
Click on All, Built-in or Custom buttons to filter the dashboard or use the search to find a dashboard by name.
Click Create custom dashboards to create a new dashboard. See Creating dashboards for more details.
The list is organized by Dashboard name and Last edited.
The action menu at the end of each row shows:
Edit: Available to custom dashboards only.
Duplicate: Available to custom and built-in dashboards.
Delete dashboard: Available to custom dashboards.
Viewing dashboards
Dashboards comprise configurable widgets. Depending on the type of a measure they represent, the widgets are count, rating badge, line chart, pie and donut charts.
Count
Count represents a single metric. It displays a numerical value for a measure, for example, the number of security hotspots or the percentage of debt ratio.
In the upper-right corner, the chart shows whether the data is applied to new or overall code.
If enabled during widget creation, the widget displays the net change in the last 30 days. Click on it to investigate further on the Activity page.
Rating badge
A rating represents a single metric. It displays the current rating for a measure, for example, a security rating or reliability rating.
In the upper-right corner, the chart shows whether the data is applied to new or overall code.
Line chart
A line chart represents metrics that change over time, displaying historical data for a selected measure.
Hover over the line to reveal a tooltip with additional information.
In the upper-right corner, the chart shows that data is applied to overall code, which is the only option for line charts.
If enabled during widget creation, the chart displays a legend.
Pie and donut charts
Pie and donut charts display information for multiple metrics.
Hover over a section of the pie or donut chart to reveal a tooltip with more information.
Click on the pie or donut chart sections, or on the legend, to drill down into the metrics.
In the upper-right corner, the chart shows whether the data is applied to new or overall code.
If enabled during widget creation, the chart displays a legend.
See Metrics for more information about metrics and associated visualizations.
Missing a visualization or metric?
Your feedback is important to us. Submit your ideas for a visualization or metric that you would like to see in Dashboards through our Portal card.
Editing a dashboard
Navigate to the dashboard you wish to edit and select Edit from the action menu located in the upper-right corner of the page. Alternatively, you can navigate to the All dashboards page and select Edit from the action menu located on the right-side of the dashboard you wish to edit.
In the edit mode you have an option to:
Cancel and exit: Exits the edit mode without saving the changes.
Save changes: Saves the existing changes.
Add widget: You can choose from available widgets.
Add section: Sections group a set of widgets together and are collapsible.
See Creating dashboards for more details about how to create and customize the widgets and sections.
Organizing your dashboards
Widgets
You can organize widgets by moving them from one section to another. In edit mode, click the handle located in the top-left corner of a widget and drag it to another location.
Additionally, you can resize a widget by clicking and dragging its lower-right corner.
Sections
Similarly to widgets, you can drag sections from one location of the dashboard to another.
Sections are collapsible, even after you save the changes and exit the edit mode. This can help you save screen real estate and show only information that is important to you at a given moment.
Related pages
Last updated
Was this helpful?