The first time a predefined insight output is used in an insight metric of a thing definition, according to the output definition, on the object hierarchy (thing, location, customer) additional properties are automatically created. These insight properties are used to save, on the thing, location and customer levels the insight value aggregated over a predefined time frame.
Insight properties are computed once the insight computation is completed for a certain thing (after the midnight, local time of the thing).
AVG LAST 30 DAYS: the average of insight values of the last 30 days.
AVG LIFETIME: the average of insight values since the thing was registered.
SUM LAST 30 DAYS: the sum of insight values of the last 30 days.
SUM LIFETIME: the sum of insight values since the thing was registered.
The aggregation function (AVG or SUM) used to calculate property values depends on the nature of the mapping output; for example, percentages will be averaged, while other numerical outputs (e.g. time, pieces) might be summed.
The same properties are available on the location and customer levels, but in this case the aggregation is made on all the underlying things. Note that the things whose insight value is aggregated are all, any user-to-thing authorization is ignored.
For more details on the available properties, you can refer to the output description in the documentation page of the predefined insights.
How to use insight properties?
Insight properties on thing, location and customer levels can be used to:
Sort/filter object into lists.
For instance, you can sort customers by an insight averaged over the last 30 days or lifetime.Compute statistics groups and count objects by thresholds.
For instance, you can count customers and group results by insight thresholds (e.g. Good, Poor, Bad).
Editing insight properties
If needed, the insight properties can be edited within the Properties section of the Console.
For instance, you can modify the label, description, or dictionary and thresholds.
Insight properties use the Insight Data Binding to keep the value updated with the insight computed value. For more details, you can refer to the Data Binding article.