Measurement lifecycle

After creation of a measurement, the collector will start collecting data (make sure the collector is configured ).

Measurement detail

Status Active

Once the measurement has been picked up by the collector, the measurement status will be Active and the measurement quality will be indicated.

Status Paused

The data collection for one measurement can be temporarily stopped by pausing the measurement. The measurement status will be Paused, until the data collection for this measurement is manually resumed.

Status Deleted

If you no longer need a measurement, you can delete it in the measurement detail view. After deletion, a measurement is not visible anymore and is given a status Deleted. Deleted measurements can only be restored using the bulk import functionality, overwriting the measurement with the same name and database and optionally differing measurement settings.

Status Discovered

Certain collectors have the capability to automatically discover measurements. Discovered measurements are not collecting data. A discovered measurement can be promoted to status Active by filling in the Database field (if it is not yet filled in) and optionally changing the measurement name.

Discovered measurements can be deleted, but it is always possible that the deleted measurement can be rediscovered.

Measurement quality

The quality of a measurement can be either Good or a variant of Bad.

Quality Good

When properly configured, the measurement quality will be indicated as Good. With this quality, the measurement is collecting data points.

Quality Bad

Indicating a Bad quality, the measurement is most likely wrongly configured and thus the measurement is not collecting any data points. A status message will be displayed as the measurement quality (f.e. BadInvalidDataType), which should guide you in helping to resolve the issue.

The measurement quality is derived from the the status code given by the industrial protocol in use.

Quality filter

To get an overview of measurements with a Bad quality, you can toggle a filter (the red exclamation mark icon) highlighting only Bad quality measurements.

Measurement list with bad quality

To only show Good quality measurements, you can toggle the filter with the checkmark icon.

Measurement list with good quality

Quality history

By default, the current measurement quality is indicated for every measurement that is in an active state. However, underneath the measurement detail view a history of the measurement quality is shown.

The measurement quality history shows the last 100 changes of the measurement quality.

Measurement quality history

Status of data points

Each data point receives a Status tag describing the quality of that particular data point from the measurement. This reflects the actual quality of the measurement at that point in time. A data point can f.e. have a Status tag indicating Good, BadInvalidDatatype, BadTimeOut, …

As an end user, querying for the Status tag in Grafana can be a valuable addition to verify the quality of the requested data points before performing any trending/calculations/analytics.

References

Measurements are used in a lot of places, you can keep track where and how many times a measurement is referenced to in it’s detail view. By clicking on the number a modal opens with all the calculations, event (property) configurations, event properties, or asset properties a measurement is referenced.
Clicking the reference will take you to that screen in the frontend.

Measurements which are referenced in calculations or asset properties can’t have their datatype updated.

Measurement references