TriggerCondition for Telemetry 2 Report Profiles

The TriggerCondition property is an array of objects that define the condition(s) under which the T2 report should be generated.  Similar to Parameters, each object specifies the type of data for the condition.

Each object defines a condition upon which the report should be generated. If any one condition evaluates to TRUE, the report is generated immediately.  This behaves like all conditions are OR'd. The first evaluation to TRUE will cause further evaluations to cease, and the report will be generated.

TriggerCondition is OR'd with ReportingInterval, such that report generation occurs when the reporting interval is reached OR when a condition evaluates to TRUE. If TriggerCondition is present, ReportingInterval is optional.  If GenerateNow is used, TriggerCondition may not be present.

The Telemetry 2 component uses rbus to subscribe for changes and conditions to the dataModel property specified in each TriggerCondition object.

NOTE: Only "dataModel" data is supported for TriggerCondition objects in the RDK releases.

Example

{
    "type": "dataModel",
    "reference":"Device.WiFi.Radio.1.Stats.X_COMCAST-COM_NoiseFloor", 
    "operator":"gt","threshold":"-65", "minThresholdDuration":120
}

Available Properties

type

Defines a data model parameter, e.g., TR-181 data.

type

• is required
• Type: string

type Constraints

constant: the value of this property must be equal to:

"dataModel"

reference

The data model object or property name whose value is to be in the generated report, e.g., "Device.DeviceInfo.HardwareVersion"

reference

• is required
• Type: string

operator

Indicates the filter type used in conjunction with a trigger condition. If the data type of the dataModel parameter is string or date/time, then only the “any” filter type applies.

name

• is required
• Type: string

operator Constraints

enum: the value of this property must be equal to one of the following values:

threshold

The operand value to use during evaluation of the condition if the operator is not "any".  If operator is "any", then threshold is ignored.  For boolean data types, TRUE and FALSE are represented by "1" and "0", respectively.

threshold

• is optional
• Type: integer

minThresholdDuration

Minimum time, in seconds, between report generation if condition reoccurs or persists. This will help prevent device from bogging down generating the same report over and over. If not specified, a new report will be generated every time this Trigger Condition is satisfied.

threshold

• is optional
• Type: integer