Custom Dashboards provide a toolbox for building your own visual interface around Harness data, using flexible filtering and criteria. By creating and fine-tuning visualizations that slice and dice your data, you can identify and optimize development and deployment velocity, bottlenecks, rollback durations, and other useful metrics. This topic covers:
- Navigating Dashboards
- Creating and Managing Dashboards
- Adding and Configuring Dashboard Widgets
- Primary Widgets
- Custom Widgets
- Using Dashboards
- Putting It All Together
- Account Administrators
Custom Dashboards expand on Harness Manager's default Main and Services Dashboards. They enable you to visualize and prioritize the deployment and related data that matters to you, in flexible display formats.
Each authorized Harness user has the option to build multiple dashboards, for different reporting purposes.
You create each dashboard around Harness’ rich set of setup, runtime, and instance data.
Insert Harness' Primary Widgets, or build your own Custom Widgets. Primary Widgets display basic DevOps metrics like deployment frequency, lead time to production, mean time to restore, and change failure rate. You can further refine all Widgets to meet your needs.
Once you've placed your Widgets, simply drag to resize or rearrange them in this visual interface. Custom Dashboards remain editable when they're reopened.
You can choose to share each dashboard with one or more Harness User Groups.
To access Custom Dashboards, select Dashboards > Custom Dashboards.
The link at upper right will remain available once the Custom Dashboards page is populated.
As soon as one or more Custom Dashboards are available to you, the Custom Dashboards page fills in to list them:
This list view provides the controls shown below:
Creating and Managing Dashboards
A user who belongs to at least one User Group that has the
Administer Other Account Functions permission is an Account Administrator. These users can:
- View all Custom Dashboards on your Harness account—regardless of whether a dashboard has been shared with this, or any, User Group.
- Create, configure, modify, and delete Custom Dashboards.
- Add, configure, modify, and delete Widgets within Custom Dashboards.
A user who belongs to no User Group with
Administer Other Account Functions permission is a non‑administrator. These users can:
- View only Custom Dashboards that they've created themselves, or Custom Dashboards explicitly shared with at least one User Group to which they belong.
- Refresh data on dashboards' Widgets.
- Resize and move Widgets within dashboards. (But not add, reconfigure, or delete Widgets.)
Managing Groups and Permissions
Administrators can create User Groups with particular permission sets that accommodate particular audiences. For example, managers might need broad access to view and customize dashboards for reporting purposes, but not require permissions to alter the underlying Harness entities. For these users, you could create a group that includes the
Administer Other Account Functions permission, but has limited Application permissions.
Creating a Dashboard
To create a Custom Dashboard:
- Select Dashboards > Custom Dashboards. This displays the Custom Dashboards page.
- Click Create Custom Dashboard at the upper right. This displays the dialog shown below.
- Enter a Dashboard Name. This should be unique within your Harness account.
- Optionally, enter a Description. (This will be visible under the Custom Dashboards page's description icon. It can communicate the dashboard's purpose to other users, or include a warning like "Do not delete.")
- Optionally, use the Shared with User Groups multi-select to specify one or multiple groups that will have access to your dashboard.
- Click Submit. Your new Custom Dashboard will open in the initial state shown below.
Editing or Cloning a Dashboard
At a Custom Dashboard's upper-right corner, Account Administrators see these additional controls for modifying the dashboard as a whole.
The options available here are:
Click Add Widget to populate your Custom Dashboard with Widgets. (See Adding and Configuring Dashboard Widgets.)
To enter/exit Full Screen display of your dashboard, click the Expand/Collapse toggle.
To edit, clone (duplicate), or delete your dashboard, click the More Options ••• menu to display the options shown below.
To change your dashboard's name, description, and/or User Group sharing, click Edit. This reopens the dialog that you used to create the dashboard.
To create a copy of your dashboard (including all its configured Widgets), click Clone. This opens a dialog where you'll be prompted to confirm, or override, the cloned dashboard's name, description, and User Group sharing.
To remove this dashboard from your Harness account, click Delete. This displays a confirmation dialog.
Adding and Configuring Dashboard Widgets
To populate or expand a Custom Dashboard:
- Click Add Widget at the dashboard's upper right.
- From the resulting Add Widget wizard, either select one of the displayed Primary Widgets, or click Custom Widgets.
- Once you've selected a Widget to add, the Add Widget wizard displays the Configure Your Widget page shown here. Configure (edit) the Widget as outlined in the following sections.
Configure your Widget using the fields in the Add Widget wizard's left pane. (The same wizard is retitled Edit Widget when you edit an existing Widget.) Required fields are indicated by an asterisk (*).
The Filter <Widget Type> Data panel provides no default filtering. To change this, click Add Data Filter. For detailed options, see Filters, Groups, and Tags.
The Define Data Refresh Interval field has a default value of Never, unless you select an interval.
The preview pane on the right indicates the data that your Widget will retrieve. It also displays warnings about missing data, with a reminder about possible causes. You can click this pane's Update button to refresh the data after each configuration change.
Once you've configured the Widget to your satisfaction, click Create Widget at lower right to add the Widget to your Dashboard.
When you edit an existing Widget, this button's label changes to Update Widget.
Filters, Groups, and Tags
Many Primary Widget and Custom Widget types offer you the option to filter and/or group by multiple Harness entities and Tags. This provides flexibility to define and display complex relationships among your data. But because of this same flexibility:
Click Add Data Filter to begin defining a filter. Use the resulting Select Filter Type drop-down to select which Harness entity or Tag to use as the filter.
In most Widgets, the Add Data Filter link remains available to add more filters. Multiple filter rows combine using AND search logic: Each filter that you add can further narrow the returned data.
The adjacent Select Filter Values drop-down allows multiple selections. Within a given filter, values combine using OR search logic: Each value that you add can broaden the data retrievable with this filter.
To remove a filter, click the trash-can icon at its right.
Each Tag filter can target only a single entity type (Application, Environment, or Service). To filter on one or more Tags across multiple entities, add more filter rows.
Too Much Data? No Data?
Here are some tips about how to avoid unintended filter results.
The Primary Widgets Library gets you started by offering predefined visualizations of popular DevOps metrics like deployment frequency, lead time to production, mean time to restore, and change failure rate.
Below are details about the available Primary Widgets:
- Most-Active Services
- Change Failure Rate
- Deployment History
- Lead Time to Production
- Deployment Frequency
- Mean Time to Restore
This Widget corresponds to the horizontal bar chart that appears on Harness' Main Dashboard. It graphs the deployment activity of your Harness Services, in descending order. This version is customizable by data refresh interval.
Each bar's length indicates the number of times each Service has been deployed. Colored bands show a breakdown by deployment status. (Scroll to the Widget's bottom to display a legend by color.)
For this Widget, Harness Services are the only entity available for measurement, and Applications are the only available filters.
Change Failure Rate
This Widget visually ranks your Harness Services by their consistency of deployment success, in descending order.
You can customize the chart's data refresh interval.
For this Widget, Harness Services are the only entity available for measurement. You can filter on Applications, Environments, and Service Tags.
This Widget is a customizable (by time range) version of the Deployments bar chart that appears on Harness' Main Dashboard.
For this Widget, deployments are the only entity available for measurement, and time intervals are the only available filters.
Lead Time to Production
This Widget shows the average duration of deployments, per Application, over a selectable time range. The display shows one diamond node for each Application.
For this Widget, deployments are the only entity available for measurement. You can filter on multiple Harness entities and Tags.
This line chart shows the daily frequency of deployments, per Application. You can customize the Time Filter (range), and can filter on multiple Harness entities and Tags.
Mean Time to Restore
This line chart shows the average rollback duration, per Application. You can customize the Time Filter (range), and can filter on multiple Harness entities and Tags.
Custom Widgets offer less predefined structure than Primary Widgets, but much more flexibility. You first select a principal Harness entity that you want to analyze. Next, you select a visualization type. Finally, you can closely configure details, including visual formatting, time range, groupings, and additional filters.
Custom Widget Types
The following entities are available at the top level. Harness considers each to be a Custom Widget type:
Under each Custom Widget type, a row of buttons enables you to select a supported visualization type. You'll see some or all of these options, depending on which entity you're selecting:
Configuring Custom Widgets
To set up a Custom Widget:
- Click Add Widget at a Custom Dashboard's upper right.
- From the resulting Add Widget wizard, click Custom Widgets.
- Scroll to the type of Harness entity you want to analyze.
- Click to select a visualization type available for this Widget type.
This opens the Add Widget wizard (alternately labeled Update Widget if you're reconfiguring an existing Widget).
You can change the visualization type here by clicking a different type on the upper-left button row.
- As you configure your Widget in the left pane, click the right pane's Preview Real Data button (relabeled Update after your first click) to preview the result of each configuration change.
The fields available at left depend on the Widget type (Harness entity) and visualization type you've selected. We provide tips for specific combinations in the sections below, but in general:
- The Title field is required. Enter a title that is unique on this Custom Dashboard.
- The Filter Data panel defaults to empty/unfiltered. For the controls you use to fill it in, see Editing Widgets. For filtering logic, see Filters, Groups, and Tags.
- The Metric always defaults to Count, unless you select a different measurement quantity.
- The Group By drop-down offers a variety of Group By Entity, Group By Time, and Group By Tag options. (Update the preview pane to verify the grouping you want.)
- A Second Group By option is also available in some Widget/visualization combinations.
- To display a time series, you must set at least one Group By field to a time interval.
- Click Create Widget to add the Widget to your Dashboard.
When displaying Deployments as a bar chart, if you Group By a granular entity (such as Services, Environments, or Cloud Providers) or Tag, the displayed count can increase. This is because the display now includes the count for these entities or Tags.
Compared to a donut chart, a bar chart provides more ways to define and display your data: Using the added Second Group By option, you can display a time series, or you can plot an X/Y relationship among two entities or Tags.
Line Chart and Area Chart
For these visualization types, the Second Group By setting must always be a time interval, building a time series. Use the Group By field to break down the displayed totals by any entity or Tag you want.
This visualization type (selectable with a "21” icon) simply displays a Total Count. It offers no Group By options and no clickable chart segments, but users can click its View Details link to pass through to the Harness Manager details aggregated in the total.
On each Widget, the controls and options highlighted below are available to all users:
On Aggregate Value visualizations, click this link to access the underlying data.
Modifying Existing Widgets and Dashboards
Account Administrators see additional controls for modifying a dashboard's existing Widgets, and for modifying the dashboard itself:
Click a Widget's More Options ••• menu to display the options shown here.
Remove deletes the Widget from this Custom Dashboard.
If you've customized the Widget's configuration, this also removes that configuration from your Harness account. This action cannot be undone. Consider first cloning a backup copy of the current dashboard.
Edit reopens controls for configuring the Widget.
These controls at the dashboard's upper right modify the dashboard as a whole. For details, see Editing or Cloning a Dashboard.
Putting It All Together
Using the options outlined above, you can assemble Custom Dashboards that combine a diversity of monitoring/reporting metrics, and visualization types, in one place. Your needs and imagination define what's possible.