Skip to content

Commit 51cbe1f

Browse files
authored
Merge pull request #101503 from dominicbetts/vanessa-rule-threshold-update
Update screenshots for IoT Central rules
2 parents 45dd644 + cdaffa2 commit 51cbe1f

23 files changed

+24
-19
lines changed

articles/iot-central/core/howto-create-telemetry-rules.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Devices can use telemetry measurement to send numerical data from the device. A
2222

2323
## Create a telemetry rule
2424

25-
To create a telemetry rule, the device template must have at least one telemetry measurement defined. This example uses a refrigerated vending machine device that sends temperature and humidity telemetry. The rule monitors the temperature reported by the device and sends an email when it goes above 80 degrees.
25+
To create a telemetry rule, the device template must have at least one telemetry measurement defined. This example uses a refrigerated vending machine device that sends temperature and humidity telemetry. The rule monitors the temperature reported by the device and sends an email when it goes above 70° F.
2626

2727
1. Using the **Device Templates** page, navigate to the device template for which you are adding the rule for.
2828

@@ -38,7 +38,7 @@ To create a telemetry rule, the device template must have at least one telemetry
3838

3939
1. Enter a name that helps you to identify the rule in this device template.
4040

41-
1. To immediately enable the rule for all the devices created for this template, toggle **Enable rule for all devices for this template**.
41+
1. To immediately enable the rule for all the devices created for this template, toggle **Enable rule for all devices of this template**.
4242

4343
![Rule Detail](media/howto-create-telemetry-rules/rule_detail1.png)
4444

@@ -53,8 +53,8 @@ Condition defines the criteria that is monitored by the rule.
5353
1. Select the telemetry you want to monitor from the **Measurement** dropdown.
5454

5555
1. Next, choose **Aggregation**, **Operator**, and provide a **Threshold** value.
56-
- Aggregation is optional. Without aggregation, the rule triggers for each telemetry data point that meets the condition. For example, if the rule is configured to trigger when temperature is above 80 then the rule triggers almost instantly when the device reports temperature > 80.
57-
- If an aggregate function like Average, Min, Max, Count is chosen then, the user must provide an **Aggregate time window** over which the condition needs to be evaluated. For example, if you set the period as "5 minutes" and your rule looks for Average temperature above 80, the rule triggers when the average temperature is above 80 for at least 5 minutes. The rule evaluation frequency is the same as the **Aggregate time window**, which means, in this example, the rule is evaluated once every 5 minutes.
56+
- Aggregation is optional. Without aggregation, the rule triggers for each telemetry data point that meets the condition. For example, if the rule is configured to trigger when temperature is above 70° F then the rule triggers almost instantly when the device reports temperature > 70.
57+
- If an aggregate function like Average, Min, Max, Count is chosen then, the user must provide an **Aggregate time window** over which the condition needs to be evaluated. For example, if you set the period as "5 minutes" and your rule looks for Average temperature above 70, the rule triggers when the average temperature is above 70° F for at least 5 minutes. The rule evaluation frequency is the same as the **Aggregate time window**, which means, in this example, the rule is evaluated once every 5 minutes.
5858

5959
![Condition](media/howto-create-telemetry-rules/aggregate_condition_filled_out1.png)
6060

@@ -85,7 +85,7 @@ You can add other actions to the rule such as Microsoft Flow and webhooks. You c
8585

8686
## Parameterize the rule
8787

88-
Rules can derive certain vales from **Device Properties** as parameters. Using parameters is helpful in scenarios where telemetry thresholds vary for different devices. When you create the rule, choose a device property that specifies the threshold, such as **Maximum Ideal Threshold**, instead of providing an absolute value, such as 80 degrees. When the rule executes, it matches the device telemetry with the value set in the device property.
88+
Rules can derive certain vales from **Device Properties** as parameters. Using parameters is helpful in scenarios where telemetry thresholds vary for different devices. When you create the rule, choose a device property that specifies the threshold, such as **Maximum Ideal Threshold**, instead of providing an absolute value, such as 70° F. When the rule executes, it matches the device telemetry with the value set in the device property.
8989

9090
Using parameters is an effective way to reduce the number of rules to manage per device template.
9191

10.8 KB
Loading
-282 Bytes
Loading
10.3 KB
Loading
8.74 KB
Loading
-6.15 KB
Loading
2.17 KB
Loading
1.95 KB
Loading
-15.3 KB
Loading
4.62 KB
Loading

0 commit comments

Comments
 (0)