---
title: "How to use Insight Metrics"
slug: "how-to-use-insight-metrics"
updated: 2024-10-25T11:06:34Z
published: 2024-10-25T11:06:34Z
canonical: "learn.servitly.com/how-to-use-insight-metrics"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://learn.servitly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to use Insight Metrics

The *Insight Metrics* can be displayed within the dashboards by using the standard widgets supporting metrics, like:

- [Gauge](/docs/gauge-widget)
- [Radial Gauge](/docs/radial-gauge-widget)
- [Time Series Chart](/docs/time-series-chart-widget)
- [Location Details](/docs/location-details-widget)
- [Thing Details](/docs/thing-details-widget)
- [Location List](/docs/location-list-widget)
- [Thing List](/docs/thing-list-widget)
- [Multi Metric List](/docs/multi-metric-list-widget)

## Displaying Insight values

For instance, here is an example with a Gauge displaying the *Performance* insight.

```xml
<value-widget>
   <metric name="performance"></metric>
</value-widget>
```

This is the dashboard rendering:

![](https://cdn.document360.io/6759e9c9-3ce3-49df-965a-7231d2d9a10a/Images/Documentation/image(158).png?sv=2026-02-06&spr=https&st=2026-10-16T17%3A30%3A37Z&se=2026-10-16T18%3A30%3A37Z&sr=c&sp=r&sig=NBcoGQQIcGtk6hcgaWhXWN%2FtX6%2FKRQ2F0w04Sky3A%2F4%3D)

## Sorting by Insight value

When the algorithm computation takes place, each location object is enriched with the *metrics* node holding the values of the last insight computation.

```json
{
	"id": "5aeae7f44e22a20006f6145d",
	"name": "Location A",
	"metrics": {
		"performance": {
			"value": "0.5136519825098697",
			"lastUpdateTimestamp": 1627479405261
		}
	}
}
```

This allows for instance to display a list of locations/things and sort by the insight value.

```xml
<location-list-widget-v2>
  <property name="name"></property>
  <property name="properties.street"></property>
  <property name="properties.city"></property>
  <property name="thingCount"></property>
  <property name="metrics.performance.value"></property>
</location-list-widget-v2>
```

Note that, insight properties are not updated when using the *Test Algorithm* feature within the Insight Metric editing page.