When the resource usage of IoT Platform reaches the specified threshold in an alert rule, an alert is triggered. Then, Alibaba Cloud sends a notification to the specified alert group.

Notifications for threshold alerts

When an alert is triggered based on a threshold-triggered alert rule, alert contacts receive an alert notification email, as shown in the following figure.

Alert notification email
Table 1. Notification content and descriptions
Field Description
IoT Platform instance The information about the instance that triggers the alert. This information contains the product key (productKey), instance ID (instanceId), and region ID (regionId).
Metric The code of the metric that you selected when you set the Rule Description parameter.

In this example, the code "MessageCountForwardedThroughRuleEngine_MNS" indicates the number of messages that are forwarded by the rules engine. If the number of messages exceeds the specified threshold during a period of time, an alert is triggered.

For more information about the codes of metrics, see Table 2.

Alert time The time when the alert is triggered.
Count The total number of messages, the number of forwarded messages, or the number of connected devices that are counted for the specified metric.
Duration The period of time during which the number exceeds the specified threshold.
Rule details The details of the alert rule that you configured in the Cloud Monitor console.
Table 2. Metric codes and descriptions
Code Description
MessageCountForwardedThroughRuleEngine_FC The number of messages that are forwarded by the rules engine. It equals the number of times that the rules engine forwards data to Function Compute.
MessageCountForwardedThroughRuleEngine_MNS The number of messages that are forwarded by the rules engine. It equals the number of times that the rules engine forwards data to Message Service (MNS).
MessageCountForwardedThroughRuleEngine_OTS The number of messages that are forwarded by the rules engine. It equals the number of times that the rules engine forwards data to Tablestore.
MessageCountForwardedThroughRuleEngine_RDS The number of messages that are forwarded by the rules engine. It equals the number of times that the rules engine forwards data to ApsaraDB RDS.
MessageCountForwardedThroughRuleEngine_REPUBLISH The number of messages that are forwarded by the rules engine. It equals the number of times that the rules engine forwards data from the current topic to other topics.
MessageCountSentFromIoT_HTTP_2 The number of messages that are sent from IoT Platform by using HTTP/2.
MessageCountSentFromIoT_MQTT The number of messages that are sent from IoT Platform by using Message Queuing Telemetry Transport (MQTT).
MessageCountSentToIoT_CoAP The number of messages that are sent to IoT Platform by using Constrained Application Protocol (CoAP).
MessageCountSentToIoT_HTTP The number of messages that are sent to IoT Platform by using HTTP.
MessageCountSentToIoT_HTTP/2 The number of messages that are sent to IoT Platform by using HTTP/2.
MessageCountSentToIoT_MQTT The number of messages that are sent to IoT Platform by using MQTT.
OnlineDevicesCount_MQTT The number of devices that are connected to IoT Platform by using MQTT in real time.
DeviceEventReportError The number of event reporting failures.
DevicePropertyReportError The number of property reporting failures.
DevicePropertySettingError The number of property setting failures.
DeviceServiceCallError The number of service calling failures.

Notifications for event alerts

When an alert is triggered based on an event-triggered alert rule, alert contacts receive an alert notification email, as shown in the following figure.

Alert notification email
Table 3. Notification content and descriptions
Field Description
Event name The code of the event that triggers the alert. In this example, the code "Device_Connect_QPM_Limit" indicates the event that the number of connection requests sent per minute by a device reaches the upper limit.

For more information about the codes of events, see Table 4.

Object The resource that triggers the alert.
  • resourceId: the ID of the resource.

    Format:

    acs:iot:$regionid::instance/$instanceId/product/$productKey/device/$deviceName
  • Resource name: the ID of the instance. iot-public indicates that this instance is a public instance.
  • Group ID: the ID of the group to which the device belongs. If the device does not belong to a group, the value of the field is an empty string.
Event level All events trigger WARN-level alerts.
Event time The time when the event occurs.
Event status All events are set to the Fail state. This state indicates that the subsequent request failed because the number of connection requests that are sent per minute or the number of messages that are sent per second reaches the upper limit.
Details The information about the resource that triggers the alert. The information is in the JSON format. This information contains the region ID (regionId), instance ID (instanceId), product key (productKey), and device name (deviceName). The productKey and deviceName parameters are included in the notification only when the number of connection requests that are sent per minute, the number of messages that are sent per second, or the number of messages that are received per second by a device reaches the upper limit.
Table 4. Event codes and descriptions
Code Description
Device_Connect_QPM_Limit The number of connection requests that are sent per minute by a device reaches the upper limit.
Device_Uplink_QPS_Limit The number of messages that are sent per second by a device reaches the upper limit.
Device_Downlink_QPS_Limit The number of messages that are received per second by a device reaches the upper limit.
Account_Connect_QPS_Limit The number of connection requests that are sent per second by the current account reaches the upper limit.
Account_Uplink_QPS_Limit The number of messages that are sent per second by the current account reaches the upper limit.
Account_Downlink_QPS_Limit The number of messages that are received per second by the current account reaches the upper limit.
Account_RuleEngine_DataForward_QPS_Limit The number of messages that are forwarded per second by the rules engine for the current account reaches the upper limit.