Skip to main content

Alarm Management

This guide will provide you with a comprehensive understanding of Aqara Studio’s alarm services, including configuration, viewing, and handling of alarms. Through uninterrupted real-time monitoring of all connected devices, the Alarm Center presents various alarm information collectively. It allows you to detect and address potential risks promptly and safeguard the security and stability of smart spaces.

Overview

Aqara Studio offers complete alarm monitoring and management features. It comes with preset default alarm rules for monitoring protocol communication exceptions and device disconnections. Also, it supports user-defined alarm strategies. Therefore, users can detect risks and respond quickly in real time.

  • Multi-dimensional parameter binding: Device properties (such as temperature, humidity) and business parameters (such as device operation mode) can be linked to trigger alarms dynamically.
  • Typical configuration examples:
    • When the device temperature continuously exceeds 80°C for 5 minutes, a "High Temperature Alarm" is triggered.
    • When the instantaneous device power drops below 10W, a "Low Power Abnormal Alarm" is triggered.
    • When the device is in "Night Mode" and a motion signal is detected, a "Night Intrusion Alarm" is triggered.

In addition, the Alarm Center in Aqara Studio centrally presents the latest 10,000 alarms, covering critical information such as alarm events, types, sources, and states for unified viewing and management by users.

Alarm Classes

Alarms can be divided into two classes: system default alarms and custom function point alarms:

DimensionSystem Default AlarmCustom Function Point Alarm
MeaningAlarm for basic operational status of the device.Alarms based on device function points (such as temperature, humidity, battery, etc.).
NameDevice Alarm Class
  • Normal
  • Urgent
  • Important
  • Other names customized by users
Configured byAqara StudioUser
ConfigurabilityNot modifiableCreatable, modifiable, deletable
Trigger ConditionCommunication errors, and device offlineDevice function point value meets user-defined alarm rule
tip

System default alarms are used to ensure the basic availability of the platform and devices; these rules are maintained by the system and cannot be modified or deleted by users.

Function Point Alarm Configuration

Please refer to the Configure Point Alarms document for details on how to configure and customize alarm rules for device function points, enabling real-time monitoring and timely response to abnormal states.

Alarm Confirmation

The alarm confirmation process includes viewing and confirming alarms, described in detail as follows:

  1. Click Alarms in the left navigation bar to display all alarms in a list.

  2. Alarm information mainly includes the following fields:

    FieldDescription
    TimestampSpecific time when the alarm occurred.
    UUIDUnique identifier of the alarm.
    Alarm SourceAlarm source. Content varies depending on alarm type; for custom alarms, double-click to view specific device info.
    Source StateCurrent state of the alarm, including:
    • NORMAL
    • OFF_NORMAL
    Alarm ClassClassification of the alarm, see Alarm Classes.
    Alarm DataDetailed alarm data, varied by alarm type.
    PriorityUrgency level of the alarm.
    Normal TimeTime when the alarm is cleared/recovered to normal.
    Ack stateWhether the alarm is confirmed, including:
    • UN_ACKED: The alarm is not confirmed.
    • ACKED: The alar is confirmed.
    • ACK-Pending: Aqara may take a long time to confirm, and once done, it switches to ACKED automatically.
    Ack TimeThe time when the alarm was confirmed.
    UserUser name of the person performing the confirmation.
    Last UpdatedMost recent update time of the alarm information.
  3. Double-click any alarm to open a detail popup showing full information of the alarm. For function point custom alarms, you can accurately locate which device and function point triggered this alarm in the popup.

  4. At the bottom of the detail popup, click the Confirm alarm button, indicating the alarm has been acknowledged. Afterwards, the alarm’s ack state will change to ACKED or ACK-Pending.

  5. As prompted by the alarm content, you may further investigate and handle protocol anomalies, device offline, etc. After resolving the root cause, the alarm state will switch from OFF_NORMAL to NORMAL automatically.

Alarm Data Details

Different classes of alarm records contain different data fields. See the tables below:

System Default Alarm Fields

Field NameDescription
sourceNameAlarm source, usually device name or protocol name.
msgTextDescription of the alarm event.
TimeZoneTime zone information of the device.

Function Point Custom Alarm Fields

Field NameDescription
offNormalValue(OFF_NORMAL only) The actual value of the abnormal property detected.
alarmValue(OFF_NORMAL only) Original threshold value of the alarm.
presentValueReal-time value of the current function point.
fromStateStatus before the change.
toStateStatus after the change (current status).
sourceNameAlarm source; by default, the device function point name.
timeDelayTime delay (seconds) required to trigger the alarm.
timeDelayToNormalTime delay (seconds) to notify to alarm recovery.
msgTextDescription of the alarm event.
countNumber of occurrences of this alarm.
deadBand(Numeric only) Deadband threshold range.
highLimit(Numeric only) Permitted upper value limit.
lowLimit(Numeric only) Permitted lower value limit.
numericValue(Boolean/Enum type) Numeric value corresponding to the boolean value or the enumeration.
TimeZoneTime zone information of the device.
tip

System default alarm data is usually concise, focusing on the source and content; function point custom alarms provide richer and more detailed attribute and status information as per configuration, helping users quickly locate and analyze the cause.

Alarms Page configuration

Configure Visibility

To hide specific fields in the list, click the gear icon in Alarms. In the pop-up, uncheck the fields you do not wish to display.

Filterr Data

To filter data in the Alarms page, click the "Filter" icon. In the pop-up, set filter criteria for list fields, and check those fields for which you want the filter to take effect:

FieldConfiguration Description
TimestampThe time when the alarm occured.
  • Start Time: Set the upper limit of the time range.
  • End Time: Set the lower limit of the time range.
  • Min Enabled(Enable Start Time): Whether to enable start time.
  • Max Enabled(Enable End Time): Whether to enable end time.
Uuid
  • Include: Set multiple alarm IDs; only alarms with these IDs will be listed.
  • Exclude: Set multiple alarm IDs to exclude from the alarm list.
Source StateFilter: Select required alarm states (multi-selection supported), and only alarms with these states will be shown.
Alarm Source
  • Include: Set multiple alarm sources; only alarms from these sources will be listed.
  • Exclude: Set multiple alarm sources to exclude from the alarm list.
Priority
  • Min Value: Set minimum priority.
  • Max Value: Set maximum priority.
  • Min Enabled: Whether to enable min value.
  • Max Enabled: Whether to enable max value.
Normal TimeThe time when the alarm recovered. Its configuration is the same as Timestamp.
Ack TimeThe time when a user confirmed the alarm. Its configuration is the same as Timestamp.
User
  • Pattern: Supports entering the complete username, as well as the following fuzzy search syntax:
    • %keyword%: Search for all usernames containing the keyword.
    • keyword%: Search for usernames starting with keyword.
    • %keyword: Search for usernames ending with keyword.
  • Exact: Whether an exact match is required.
  • Include: Whether the list includes usernames containing the specified text or not.
  • Match Case: Whether case sensitivity is enabled.
Alarm DataFilter Entries: Filter alarms containing these data pairs via key-value pairs. Supports adding multiple key-value pairs.
Last UpdateThe time when the alarm upates for the last time. Its configuration is the same as Timestamp.

FAQ

How to quickly locate the device that triggered a function point custom alarm?

When creating a function point custom alarm rule, if you use the system default function point name, the alarm source shown in the Alarm Center will often be something like Switch - On/Off, which does not intuitively indicate which device went wrong.

The way to find the specific device is as follows:

  1. Double-click the alarm to pop up the detail window and find the "Alarm Source" path information in the window.
  2. In the path, the communication node indicates the protocol, followed by the protocol used by the device (such as Aqara), and then the device name.

For example, if the alarm source path is:
local:|station:|property:/communication/Aqara/Wall Switch H1 (With Neutral, Single Rocker)/points/BinaryOutputObject/PROP_PRESENT_VALUE/alarm

  • The part after communication (here, Aqara) indicates this device uses the Aqara protocol.
  • The part after Aqara (Wall Switch H1 (With Neutral, Single Rocker)) is the full device name, indicating exactly which device triggered the alarm.

Using the above method, you can quickly locate the specific device with an anomaly.