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