Skip to main content

Insights

Insights are dashboards that make it easy to visualize and interpret metrics that are captured by SEI. With a variety of out-of-the-box widgets, you can create Insights that show the data you care about most and help you understand your engineering team's effectiveness and efficiency.

This topic explains how to create and view Insights. For information about configuring specific widgets and the metrics that are presented on widgets, go to Metrics and reports.

View Insights​

The primary way to access Insights is through the Project tab.

  1. Log in to the Harness Platform and go to the SEI module.
  2. Select the Project tab on the navigation menu, and select a Project.
  3. Select a Collection.

  1. Select Insights. The Collection's default Insight appears.

    Select All Dashboards to view other Insights. The Insights available for each Collection depend on the Insight associations. The Default label indicates the Collection's default Insight.

    To switch projects or Collections, use the Project and Collection options on the navigation menu. You can also use the breadcrumbs in the Insights header to navigate up through the Collection hierarchy.

    If integration monitoring is enabled, you can view the integration status in the Insights header.

Explore data​

Once you're viewing an Insight, you can explore the widgets and interact with the data.

Where does the data come from?

Widgets get data from integrations, which are inherited from the Collections associated with Insights. In turn, Collections inherit integrations from their associated Harness project, because integrations are configured at the project level. For more information about this hierarchy and configuring Collections, go to Collections.

You can also configure individual metrics and widgets to specify what data is used in calculations, how data is presented, and other criteria. For more information, go to Metrics and reports.

Set the Insight time​

Insight time is the time range selected by the user viewing an Insight. Widgets and reports must be configured to Use Insight Time in order for their data to update when you change the Insight time range.

If a widget or report uses a specific time range, changing the Insight time has no impact on the data shown by that widget or report.

Drill down into data​

Some widgets allow you to drill down into data. For example, you can select a segment of a bar on a bar chart to examine the data for that segment.

Access Insights from the Insights list​

  1. While viewing an Insight, select All Insights in the header, and then select Manage Insights to go to the Insights list.
  2. Select the Insight you want to view from the Insights list.
  3. Select a Collection category.
  4. Select a Collection. Upon selecting a Collection, the Insight you selected from the Insights list opens.

Create Insights​

  1. Go to any Insight. For instructions, go to View Insights.

  2. In the header, select All Insights, and then select Manage Insights.

  3. Select New Insight.

  4. Enter a Name for the Insight.

  5. Under Parameters, you can modify the following settings:

  6. Select at least one Collection category to associate with this Insight.

    All Collections and child Collections under the selected category are automatically associated with the Insight. You can refine the Insight associations after initial Insight creation.

    If you want to examine Collections under a certain Collection category, select View Collections on the Collections Categories dropdown menu.

  7. Select Create to save the Insight metadata. From here, you can add widgets or modify the Insight settings, such as Insights associations.

Add widgets​

Widgets (also known as reports) are the parts of your Insights that contain data. Widgets can present a single statistic or they can present charts, graphs, and tables that compare or combine multiple statistics.

To add widgets to Insights:

  1. Go to the Insight where you want to add the widget. Make sure you are in the correct project.
  2. Select Settings, and then select Add Widget.
  3. Select the widget that you want to add.
  4. Configure the widget settings. For information about configuring specific widgets go to Metrics and reports.
  5. Select Next: Place Widget and arrange the widget on the Insight.
  6. Select Save Layout.
Where does the data in widgets come from?

Widgets get data from integrations, which are inherited from the Collections associated with Insights. In turn, Collections inherit integrations from their associated Harness project, because integrations are configured at the project level. For more information about this hierarchy and configuring Collections, go to Collections.

You can also configure individual metrics and widgets to specify what data is used in calculations, how data is presented, and other criteria. For more information, go to Metrics and reports.

Manage Insights associations​

There are two ways to manage the Collections associated with Insights:

  • When viewing Insights, select the Settings icon, and then select Collections.
  • From the Edit Collection page, edit the Insights settings. For more information about this option, go to Managing Insights associations in Manage Collections.

Change the color scheme​

You can change the colors for values on bar charts and pie charts. The color scheme applies to all Insights.

  1. In your Harness project, go to the SEI module.
  2. Select Account.
  3. Select Customize.
  4. Select the desired color for the highest and lowest values on bar charts and pie charts.
  5. Select Add Label to configure colors for other values.
  6. Select Save.

Visibility and sharing​

Authentication, access, and user management are part of the Harness Platform. Permissions granted to users and user groups depends on their associations with resources and resource groups, which are controlled at the account and project level in Harness.

Harness SEI has three built-in user roles:

  • SEI Admin
  • SEI Collection Admin
  • SEI Viewer

For more information about authentication, access, and user management, go to the following:

Built-in Insights​

The following five Insights are included OOTB with SEI:

  • DORA Metrics
  • Dev Insights
  • Business Alignment
  • Trellis
  • Planning Insights

DORA Metrics​

Use the DORA Metrics Insight to examine your organization's DORA (DevOps Research Assessment) metrics.

If you want to create additional DORA Metrics Insights:

  1. Follow the steps to create Insights, and select both Effort Investment Profile and Effort Investment Units.
  2. Add widgets for DORA metrics.

Dev Insights​

Dev Insights examines development efforts, particularly in relation to SCM metrics, such as PR creation, merging, and review collaboration. For more information about SCM metrics and reports, go to velocity metrics and SCM reports.

Business Alignment​

The Business Alignment Insight can help visualize where your teams expend the most effort and help your teams prioritize their time. This Insight includes the following three widgets, which provide an overview of the categories or projects where engineers are allocating the most time:

  • Effort Investment Single Stat
  • Effort Investment Trend Report
  • Effort Investment By Engineer

For more information about these reports and metrics, go to effort investment metrics.

If you want to create additional Business Alignment Insights, select the Effort Investment Profile option under Parameters when creating Insights.

Trellis​

Use the Trellis Insight to examine Trellis Scores.

Planning Insights​

Use the Planning Insight to examine sprint metrics.