Analyzing Insights data#

Managing Insights dashboards.

In addition to the standard chart types described later in this topic, beta charts are available for you to try. Experimental features, such as the beta charts, are disabled by default. To enable the feature, complete the following steps:

  1. On an active UrbanCode™ Velocity server, access https://my_velocity:port/featureflags.
  2. In the Enter a feature name to enable it field, enter vsm-data-metrics. If the process is successful, the feature is added to the Enabled Features list, and the beta charts are displayed in the Beta list on the dashboard.

With Insights dashboards, you measure your organization’s progress and efficiency by applying analytic tools to your project data. Data comes from value streams, pipelines, UrbanCode Deploy applications, and other project areas. By default, all data related to the teams to which you belong are available. You set data scope by selecting built-in filters. You can set the scope by application, team, value stream, or some combination.

You can add charts to the dashboard from a large collection of DevOps chart types. Chart data is determined by the metric definition associated with a chart. When you add a chart to the dashboard, its graph area fills to reflect the filtered data. As you add multiple charts to a dashboard, the charts rearrange themselves to accommodate the new chart. When you save the dashboard, UrbanCode Velocity saves the filter and the charts that you used.

The dashboard workflow follows these general steps:

  1. Set the scope by defining a filter. You can scope data by team, application, or value stream.
  2. Set the search boundary.
  3. Add a chart to the dashboard.
  4. Customize the chart. You can change the chart style for all chart types. You can apply additional filters to some chart types, such as Deploy Count.

To manage a dashboard, complete the following steps:

  1. On the UrbanCode Velocity Home page, click Insights > Dashboards, and then select the dashboard.

    The dashboard page opens, which enables you to filter data, and apply charts.

  2. In the Dashboard page, define the data scope by completing the following steps:

    1. In the Filters area, select one or more filters.

      By default, the data for all teams to which you belong populate the charts. You can restrict the data to a specific scope by selecting filters. Filters are available for teams, applications, and value streams. For example, you can restrict data to a specific team by selecting the team. Then the charts that you add will only contain data for the selected team. You can select more than one filter. UrbanCode Velocity teams and teams integrated from UrbanCode Deploy are available.

    2. With the Calendar drop-down list, , set the search period.

      The default search boundary is 90 days.

    3. With the Group By drop-down list, set the x-axis coordinates for the charts.

      The default x-axis coordinates represent days.

  3. In the Add charts area, select a chart.

    Charts for risk, quality, and delivery flow are available.


    The chart is displayed on the dashboard. If the dashboard already contains charts, the new one is inserted in the top row. Data that matches the filter condition populates the chart.

    Note: Depending on the filter and chart type, a chart might not contain significant data.

  4. On the chart, use the Group By drop-down to set the data grouping.

    The Group By function modifies the data presentation without changing the data.

    The following illustration shows an delivery flow chart, Build Count. Each bar in the graph represents the number of software builds for the specified coordinate, in this case days. The chart's Group By function is set to Status. A chart's Group By filter is determined by the metric definition assigned to the chart and might be unique to the chart. The chart's key displays the values for this grouping. This particular chart can be grouped by name, requestor, application, and tag.

    Note: Some chart types provide a default grouping that cannot be changed.

    Build chart

    To see the breakdown of values for a grouping, hover the mouse over a graph element. The following illustration shows another delivery flow chart, Deploy Count. This chart is grouped by result. Hovering the mouse over a bar shows the results for the selected coordinate.

    Build Count chart

  5. On the chart, use the Filter drop-down, to refine the data filter.

    The chart is filtered, and the key is updated. The chart filter refines the data scope by applying additional filters to those you selected earlier.

    Note: Not all chart types provide a chart-specific filter.

  6. On the chart, use the Chart type drop-down to change the chart type.

    The types available are grouped bar, stacked bar, and line, as shown in the following illustration. The default type is Grouped bar.

    Chart types

  7. On the chart, click Dowloand CSV, Download CSV, to download a comma-separated-values file of the chart's data.

  8. Click Save.

    UrbanCode Velocity saves your filters, charts, and chart customizations.

You can create your own metric definitions and upload custom data to UrbanCode Velocity. Custom charts are displayed in the Add charts area along with the pre-defined charts.

Parent topic: Managing Insights dashboards