Turning measurement fragments on/off

To be able to match based on measurement fragments, you must ensure they are returned by setting the correct measurement format mode for the tenant.

There are two modes available, MEASUREMENT_ONLY and BOTH. The default, if it is not set or set incorrectly, is MEASUREMENT_ONLY. These options can be set it in one of two ways:

As a tenant option in the apama category, where the key is measurementFormat. This is what you should use if you are deploying the application using the Apama EPL Apps web application in Cumulocity IoT.

If you are deploying a custom microservice, connecting to Cumulocity IoT from an external correlator, or using Software AG Designer, this should be set in the properties file or directly on the command line to start the correlator by setting the CUMULOCITY_MEASUREMENT_FORMAT value.

The recommended approach is to set the value from the properties file:

CUMULOCITY_MEASUREMENT_FORMAT=BOTH

Alternatively, to set the value using the command line:

-DCUMULOCITY_MEASUREMENT_FORMAT=MEASUREMENT_ONLY

Both, EPL applications within Cumulocity IoT and custom correlators, default to MEASUREMENT_ONLY if the tenant option or property is not set.

Set the value to BOTH if you require filtering based on fragments or series.

Note:
New projects in Software AG Designer will have the default set to BOTH, but existing projects will retain their previous configuration. If you want to enable fragments in an existing project, you may need to remove and re-add the bundle.