Version 61.1 by Alec Chen on 2025/11/25 11:50

Hide last authors
Alec Chen 3.1 1 (% class="wikigeneratedid" id="H" %)
Alec Chen 56.4 2 This tutorial aims to guide** tenant-level users **on how to configure alarm rules and set up email notifications for each device without writing code or modifying the rule chain.
Alec Chen 1.2 3
Alec Chen 3.1 4 {{toc/}}
Alec Chen 1.2 5
Alec Chen 45.1 6 = 1. Import dashboard =
Alec Chen 1.2 7
Alec Chen 9.1 8 The Dashboard shown below displays all devices by default. [[attach:set_alarm.json||target="_blank"]]
Alec Chen 1.2 9
Alec Chen 34.3 10 [[image:https://wiki.thingseye.io/xwiki/bin/download/Downlink%20Command%20Guide/WebHome/1762933458042-294.png?width=645&height=565&rev=1.1||alt="1762933458042-294.png" height="898" width="1025"]]
Alec Chen 1.2 11
Alec Chen 8.1 12 [[image:1763627459220-746.png]]
Alec Chen 5.1 13
Alec Chen 35.2 14
Alec Chen 34.2 15 Each device's threshold are managed separately. Clicking on a device in the device list on the left will display the current device status and preset thresholds/email addresses on the right.
Alec Chen 5.1 16
Alec Chen 44.1 17 [[image:1763713260857-974.png||height="792" width="1029"]]
Alec Chen 34.2 18
19
Alec Chen 9.1 20 ----
21
Alec Chen 45.1 22 = (% id="cke_bm_9685S" style="display:none" %) (%%)2. Configure profile rules =
Alec Chen 1.2 23
Alec Chen 45.1 24 == 2.1 Create a condition to trigger an alarm when a threshold is reached. ==
Alec Chen 1.2 25
Alec Chen 34.3 26 (% class="wikigeneratedid" id="H70B951FB7F168F9156FE68078FDB51657F168F916A215F0F5E7665B05EFA62A58B6689C45219" %)
Alec Chen 45.1 27 Click the edit icon to enter edit mode and create a new alarm rule.
Alec Chen 1.2 28
Alec Chen 34.3 29 (% class="wikigeneratedid" id="H-1" %)
30 [[image:1763630110726-980.png||height="720" width="1014"]]
Alec Chen 12.1 31
Alec Chen 34.3 32 [[image:1763630224004-924.png||height="720" width="1014"]]
Alec Chen 1.2 33
Alec Chen 34.3 34 [[image:1763630671736-678.png||height="721" width="1015"]]
Alec Chen 11.1 35
Alec Chen 34.3 36 [[image:1763630710302-584.png||height="721" width="1015"]]
Alec Chen 12.1 37
Alec Chen 34.3 38 [[image:1763630805148-569.png||height="721" width="1015"]]
Alec Chen 11.1 39
Alec Chen 34.3 40 [[image:1763630987781-241.png||height="721" width="1015"]]
Alec Chen 11.1 41
Alec Chen 37.1 42 [[image:1763714060349-779.png||height="782" width="1016"]]
Alec Chen 11.1 43
Alec Chen 12.1 44
Alec Chen 34.3 45 [[image:1763631366289-693.png||height="720" width="1014"]]
Alec Chen 12.1 46
Alec Chen 34.3 47 [[image:1763709709956-185.png||height="722" width="1015"]]
Alec Chen 12.1 48
Alec Chen 34.3 49
50
Alec Chen 12.1 51 ----
52
Alec Chen 45.1 53 == 2.2 Set a clear condition to clear the alarm when the data returns to normal. ==
Alec Chen 12.1 54
Alec Chen 45.1 55 The steps are similar to Create alarm, only the values ​​are set in reverse.
Alec Chen 12.1 56
Alec Chen 34.3 57 [[image:1763632387865-386.png||height="720" width="1014"]]
Alec Chen 12.1 58
Alec Chen 34.3 59 [[image:1763693498016-737.png||height="720" width="1014"]]
Alec Chen 12.1 60
Alec Chen 34.3 61 [[image:1763693573052-369.png||height="723" width="1018"]]
Alec Chen 12.1 62
Alec Chen 34.3 63 [[image:1763708672557-593.png||height="723" width="1017"]]
Alec Chen 13.1 64
Alec Chen 14.1 65
Alec Chen 45.1 66 **Save after set**
67
Alec Chen 34.3 68 [[image:1763708628399-171.png||height="723" width="1017"]]
Alec Chen 29.1 69
Alec Chen 34.3 70 [[image:1763694048124-392.png||height="722" width="1017"]]
Alec Chen 14.1 71
Alec Chen 34.3 72 [[image:1763694065009-504.png||height="722" width="1017"]]
Alec Chen 1.2 73
74
Alec Chen 34.3 75 ----
Alec Chen 17.1 76
Alec Chen 45.1 77 = 3. Configure the threshold input box =
Alec Chen 1.2 78
Alec Chen 45.1 79 == 3.1 Select the Realtime data key to display ==
Alec Chen 14.1 80
Alec Chen 45.1 81 Return to the dashboard and click on the device you want to edit.
Alec Chen 36.1 82
83 [[image:1763714842488-945.png||height="784" width="1018"]]
84
85 [[image:1763715443568-173.png||height="784" width="1019"]]
86
Alec Chen 15.2 87
Alec Chen 45.1 88 **Click "Edit mode" to enter edit mode.**
89
Alec Chen 36.1 90 [[image:1763715522992-941.png||height="785" width="1020"]]
Alec Chen 15.2 91
Alec Chen 36.1 92 [[image:1763715545212-375.png||height="786" width="1021"]]
Alec Chen 15.2 93
94
Alec Chen 45.1 95 **Delete the default key and select the key you want to display.**
Alec Chen 17.4 96
Alec Chen 42.2 97 [[image:1763717628344-632.png||height="789" width="1024"]]
Alec Chen 15.2 98
Alec Chen 36.1 99
Alec Chen 45.1 100 **Save after confirmation.**
101
Alec Chen 42.2 102 [[image:1763717656075-762.png||height="790" width="1026"]]
Alec Chen 36.1 103
Alec Chen 42.2 104 [[image:1763717678221-857.png||height="792" width="1029"]]
Alec Chen 19.1 105
Alec Chen 31.1 106
Alec Chen 17.3 107 ----
108
Alec Chen 45.1 109 == 3.2 Create Threshold KEY ==
Alec Chen 15.2 110
Alec Chen 45.1 111 Enter edit mode and select the Threshold Setting component.
Alec Chen 15.2 112
Alec Chen 42.2 113 [[image:1763717776928-677.png||height="794" width="1031"]]
Alec Chen 15.2 114
Alec Chen 42.2 115 [[image:1763717871745-156.png||height="794" width="1031"]]
Alec Chen 15.2 116
117
Alec Chen 45.1 118 **Save after add.**
119
Alec Chen 42.2 120 [[image:1763718016288-797.png||height="795" width="1033"]]
Alec Chen 17.1 121
Alec Chen 42.2 122 [[image:1763718040563-785.png||height="797" width="1035"]]
Alec Chen 40.1 123
Alec Chen 34.3 124 ----
Alec Chen 1.2 125
Alec Chen 45.1 126 == **3.3 Example** ==
Alec Chen 18.2 127
Alec Chen 42.2 128 [[image:1763718234145-302.png||height="799" width="1037"]]
Alec Chen 18.2 129
Alec Chen 34.3 130
Alec Chen 45.1 131 (% id="cke_bm_30710S" style="display:none" %) (%%)**Example of an alert email received:**
132
Alec Chen 34.3 133 [[image:1763707708365-348.png]]
134
135
136
Alec Chen 17.3 137 ----
138
Alec Chen 45.1 139 = 4. Configure Notification (only required for initial use) =
Alec Chen 1.2 140
Alec Chen 45.1 141 If this is the first time configuring the email sending function, you also need to configure the Notification to specify the recipient/template/sending rules.
Alec Chen 34.1 142
Alec Chen 45.1 143 == 4.1 Configure Recipients ==
Alec Chen 2.1 144
Alec Chen 21.1 145 (% class="wikigeneratedid" id="H" %)
Alec Chen 22.1 146 [[image:1763695480359-924.png||height="721" width="1015"]]
Alec Chen 2.1 147
Alec Chen 21.1 148 (% class="wikigeneratedid" id="H-1" %)
Alec Chen 22.1 149 [[image:1763696273020-168.png||height="721" width="1015"]]
Alec Chen 2.1 150
Alec Chen 21.1 151 (% class="wikigeneratedid" id="H-2" %)
Alec Chen 22.1 152 [[image:1763696322001-489.png||height="721" width="1015"]]
Alec Chen 2.1 153
Alec Chen 21.1 154 (% class="wikigeneratedid" %)
Alec Chen 22.1 155 [[image:1763696373932-724.png||height="722" width="1015"]]
Alec Chen 2.1 156
157
Alec Chen 22.1 158 ----
Alec Chen 21.1 159
Alec Chen 45.1 160 == 4.2 Configuring Templates ==
Alec Chen 2.1 161
Alec Chen 24.1 162 [[image:1763704822528-793.png||height="721" width="1014"]]
Alec Chen 2.1 163
Alec Chen 45.1 164 **Set Compose**
Alec Chen 2.1 165
Alec Chen 24.1 166 (% class="box" %)
167 (((
Alec Chen 25.1 168 **Web**
169
170 **Subjtct:**${alarmOriginatorName} ${alarmType}
171
172 **Message:**${alarmOriginatorName} alarmed ${alarmType}
173
174 **Email**
175
176 **Subjtct:**${alarmOriginatorName} ${alarmType}
177
178
179 **Message:**Hi ${recipientFirstName:capitalize} ${recipientLastName:lowerCase}
180
181 The ${alarmOriginatorName} alarmed ${alarmType} ,PLZ check
Alec Chen 24.1 182 )))
Alec Chen 2.1 183
Alec Chen 25.1 184 [[image:1763705354353-222.png||height="719" width="1012"]]
Alec Chen 21.1 185
Alec Chen 25.1 186 [[image:1763705373057-540.png||height="719" width="1012"]]
Alec Chen 21.1 187
188
Alec Chen 25.1 189 ----
Alec Chen 21.1 190
Alec Chen 45.1 191 == 4.3 Configure Notification Rules ==
Alec Chen 3.1 192
Alec Chen 25.2 193 [[image:1763705587312-647.png||height="719" width="1012"]]
Alec Chen 3.1 194
Alec Chen 25.2 195 [[image:1763706113413-196.png||height="721" width="1015"]]
Alec Chen 3.1 196
Alec Chen 25.2 197 [[image:1763706072650-624.png||height="722" width="1016"]]
Alec Chen 3.1 198
Alec Chen 25.2 199 [[image:1763706241273-512.png||height="722" width="1016"]]
Alec Chen 3.1 200
Alec Chen 27.1 201 [[image:1763707736962-945.png||height="723" width="1017"]]
Alec Chen 3.1 202
203
Alec Chen 51.1 204 ----
Alec Chen 3.1 205
Alec Chen 51.1 206 = Extended content: =
Alec Chen 27.1 207
Alec Chen 45.1 208 = 5. What if I want to send an email to a specific recipient? =
Alec Chen 4.1 209
Alec Chen 49.2 210 Currently, it supports three recipient types: Platform users, Slack, and Microsoft Teams. You can create a user using the email address you want to receive emails from, and then select the recipient in Platform users -> UserList.
Alec Chen 4.1 211
Alec Chen 49.1 212 [[image:1763970065522-362.png||height="550" width="1017"]]
Alec Chen 4.1 213
Alec Chen 49.1 214 [[image:1763970125819-288.png||height="550" width="1017"]]
Alec Chen 4.1 215
Alec Chen 49.1 216 [[image:1763970168381-554.png||height="551" width="1019"]]
Alec Chen 4.1 217
Alec Chen 49.1 218 [[image:1763970202306-593.png||height="552" width="1021"]]
219
220
221 ----
222
Alec Chen 45.1 223 = 6. How to set up a separate page for each device for easier management? =
Alec Chen 4.1 224
Alec Chen 61.1 225 Suppose we have a batch of AQI sensors and a batch of Tank sensors. How do we display them on two different pages or put them into an existing dashboard?
Alec Chen 33.1 226
Alec Chen 56.3 227 [[image:1764036365000-820.png||height="478" width="1022"]]
Alec Chen 51.1 228
Alec Chen 56.3 229
Alec Chen 61.1 230 Here, we will create a blank dashboard for demonstration purposes, and create two States (Pages) to distinguish and display two different types of devices.
Alec Chen 56.3 231
232 [[image:1764036526739-442.png||height="413" width="1024"]]
233
234 [[image:1764036704323-344.png||height="790" width="1027"]]
235
236 [[image:1764036761564-457.png||height="791" width="1028"]]
237
238 [[image:1764036789723-542.png||height="792" width="1030"]]
239
240
Alec Chen 61.1 241 Add a button to the default page to navigate to different Stata instances.
Alec Chen 56.3 242
Alec Chen 56.4 243 [[image:1764038418645-404.png||height="495" width="1032"]]
Alec Chen 56.3 244
Alec Chen 56.4 245 [[image:1764038440153-893.png||height="506" width="1032"]]
Alec Chen 56.3 246
Alec Chen 56.4 247 [[image:1764038459795-265.png||height="446" width="1032"]]
Alec Chen 56.3 248
Alec Chen 56.4 249 [[image:1764038595799-636.png||height="795" width="1033"]]
Alec Chen 56.3 250
Alec Chen 59.1 251 [[image:1764041017702-761.png||height="847" width="1034"]]
Alec Chen 56.3 252
Alec Chen 59.1 253 [[image:1764041058281-147.png||height="848" width="1035"]]
254
Alec Chen 56.4 255 [[image:1764038663915-300.png||height="288" width="1036"]]
Alec Chen 56.3 256
257
Alec Chen 61.1 258 Similarly, create an AQI alarm button.
Alec Chen 56.3 259
Alec Chen 56.4 260 [[image:1764038720507-522.png||height="308" width="1035"]]
Alec Chen 56.3 261
262
Alec Chen 61.1 263 Switch to Tank state
Alec Chen 56.3 264
Alec Chen 57.2 265 [[image:1764038993771-632.png||height="361" width="1040"]]
Alec Chen 56.3 266
267
Alec Chen 61.1 268 Open the Set Alarm dashboard in the new page and copy all the components there.
Alec Chen 56.4 269
Alec Chen 57.2 270 [[image:1763627459220-746.png]]
Alec Chen 56.4 271
Alec Chen 57.2 272 [[image:1764039091299-607.png||height="528" width="1028"]]
Alec Chen 56.4 273
274
Alec Chen 61.1 275 Enter the component editing page and switch the device group to be displayed.
Alec Chen 56.4 276
Alec Chen 58.1 277 [[image:1764039434202-995.png||height="496" width="1026"]]
Alec Chen 56.4 278
Alec Chen 58.1 279 [[image:1764039490910-964.png||height="497" width="1028"]]
Alec Chen 56.4 280
281
Alec Chen 61.1 282 Add a button to return to the initial page.
Alec Chen 56.4 283
Alec Chen 60.1 284 [[image:1764041404181-108.png||height="839" width="1025"]]
Alec Chen 57.2 285
Alec Chen 60.1 286 [[image:1764041446883-114.png||height="840" width="1026"]]
Alec Chen 57.2 287
Alec Chen 60.1 288 [[image:1764041476537-950.png||height="682" width="1028"]]
289
290 [[image:1764041567433-493.png||height="842" width="1028"]]
291
292
Alec Chen 61.1 293 This completes the creation of a State page that only displays Tank-class devices. The AQI State configuration can be referenced from the Tank page.
Alec Chen 60.1 294
295 [[image:1764041604908-185.png||height="843" width="1029"]]
296
297
Alec Chen 59.1 298