Add and Configure Custom Widgets

Updated 2 months ago by Archana Singh

You can add Primary and Custom Widgets to your Custom Dashboards. Custom Widgets offer less predefined structure than Primary Widgets but offers more flexibility.

In this topic:

Before You Begin

Step: Add Custom Widgets

Ensure that you select entities that contain deployment data.

For example, if you select a Workflow with only Pre-deployment and Post-deployment steps but no deployment Phases, it will not have data on deploying a Service because no Service is used. Also, this Workflow might have an Environment in its setup, but that Environment won't be used because there is no deployment Phase. Hence, there will be no Environment data to display.

In such a case, the custom dashboard columns will be null.

To add Custom Widgets, perform the following steps:

  1. Click Add Widget at the dashboard's upper right corner to populate or expand a Custom Dashboard. For more information, see Edit a Dashboard.
  2. Select Custom Widgets.
  3. Select the Custom Widget Types.
  4. Select a visualization type.

Step: Configure Custom Widgets

First, you need to Configure Your Widget (required) and then Format Graph Display (optional).

The available options will vary depending on your Widget Type selection.

This document uses Deployment Widget Type and Donut Visualization Type to demonstrate the steps required to configure the Widget.

Configure Your Widget

  1. In Configure Your Widget, in Widget Title, enter a title for your widget.
  2. Select the Time Filter.
  3. In Apply Time Filter on, select Start Time or End Time.

    If you select Start Time, then you will have two additional intermediate Status, Running and Paused.
  4. In Filter Data, Add Data Filter. For more information on filters, see Filters, Groups, and Tags.
  5. In Select Filter Type, select the filter. You can select Application, Service, Environment, Cloud Providers, Status, Tag (Application), Tag (Service), Tag (Environment), or Tag (Deployment). Filter values are listed based on your Filter type selection.
    You can add up to nine data filters.

Ensure you are familiar with Harness Tags and using variables expressions in Tag names and values. See Use Expressions in Workflow and Pipeline Tags.

This can be a very powerful method for creating Custom Dashboards. For example, let's say you had a Workflow or Pipeline Tag named commitID. The value for it is passed in as an expression, such as ${workflow.variables.commitID}. You could provide the value for the variable using a Trigger that passes in a Git commit ID.

When you deploy, the expression is evaluated and the commit ID is displayed in Deployments like commitID:521747298a3790fde1710f3aa2d03b55020575aa.

Now, you can create a Custom Dashboard for the name commitID that filters or groups deployments by each commit ID.

  • You can create a Harness Custom Dashboard that filters or groups using Tags that use expressions.
  • You can use a Tag whose name or value uses an expression, but you can only filter or group by Tag name.
  • You cannot use the expression itself to filter or group. You must use the evaluated expression displayed in Harness Deployments.

For Status the following terminal statuses are available:

  • Rejected: Filters the rejected deployments.
  • Expired: Filters the expired deployments.
  • Error: Filters the deployments with errors. This status filters the deployments with unforeseen circumstances, for example, delegate not available, corrupted data, etc.
  • Failed: Filters the failed deployments. This status filters the deployments that might have failed because of health check or configuration issues.
  • Success: Filters the successful deployments.
  • Aborted: Filters the aborted deployments.
  1. In Metric, select Count, Time Taken, or Rollback Time Taken.
  2. In Group By select, Group by Entity or Group by Tag.
    1. Group by Entity: Select Application, Environment, Service, Status, or Cloud Provider.
    2. Group by Tag: Select Tag (in Application), Tag (in Service), Tag (in Environment), or Tag (in Deployment).
    3. Select the Tag Name.

Format Graph Display

  1. In Define Data Refresh Interval, select the interval. The default value of Define Data Refresh Interval is Never.
  2. Once you have configured the Widget, click Create Widget.

View/Edit Widgets

Account Administrators can edit the existing Widgets.

  1. Click Widget's More Options •••.
  2. Select View/Edit. This reopens controls for Add Primary Widgets. You can follow the Add Primary Widgets steps to edit the configurations.
  3. Once you have configured the Widget, click Update Widget.

Remove Widgets

Account Administrators can Remove the existing Widgets. 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.

  1. In Widget, click More Options •••.
  2. Select Remove.
  3. Click Delete to remove the Widget.

Next Steps

How did we do?