Exosphere Documentation
Alerts

Create an Alert Rule

Configure a telemetry alert rule with a source, condition, channel, severity, and recipients


This guide shows how to create an alert rule from Alerts → Rules. The example monitors an HVAC actual value and sends a high-severity email when the value is too high.


Create the Rule

  1. Navigate to Alerts.
  2. Open Rules.
  3. Click New rule.
  4. Enter a Title.
  5. Optionally enter a Description.
  6. Keep Status set to Active if the rule should start evaluating after you save it.

Use a title that explains the problem without opening the rule, for example HVAC actual temperature too high.


Select the Source

  1. Open the Source card.
  2. Click the Source field.
  3. Choose whether to search Function Blocks or Function Block Sets.
  4. Search for the source.
  5. Select the required sensor or Function Block Set member type.

Alert rule source selection

Use a single sensor when one specific value matters. Use a Function Block Set when the same rule should apply to a group of similar controls.

Function Block Set behavior

When a Function Block Set is used as the source, the rule matches as soon as any member of the set matches the condition.


Configure the Condition

  1. Open the Condition card.
  2. Select the condition type.
  3. Choose the operator when the condition uses a measured value.
  4. Enter the threshold value.
  5. Enter a duration for sustained threshold or no-data conditions.
ConditionUse whenRequired settings
ThresholdA value crossing a limit should alert immediatelyOperator and threshold value
Sustained thresholdA value must stay out of range before alertingOperator, threshold value, and duration
No dataA source stops sending expected telemetryTimeout duration

Available operators are >, >=, <, <=, =, and !=.

For the HVAC example, use Threshold, operator >, and value 27.

Choose durations from the source behavior

For no-data rules, set the timeout longer than the normal reporting interval. A heat meter that reports every 15 minutes should not alert after 5 minutes of silence.


Configure the Alert Channel

  1. Open the Alert card.
  2. Click Channel to add an alert channel.
  3. Select the Severity.
  4. Select Email or SMS.
  5. Add one or more recipients, recipient groups, or external contacts.
  6. Add another channel if the same rule needs another delivery method or severity.

Alert channel settings

Use multiple channels when escalation should differ by delivery method. For example, send email to the facility team and SMS to the on-call technician for critical plant-room conditions.

SMS requires SMS Alert capacity

SMS channels require an active SMS Alert license and recipients with valid phone numbers. If the workspace does not have SMS Alert capacity, use an email channel or ask a workspace administrator to add the Exosphere Add-on Alert license under Settings → Subscription.


Add an External Contact

Use external contacts for people who are not workspace members, such as a service partner or facility helpdesk.

  1. In the Alert card, click Add external contact.
  2. Enter the contact Name.
  3. Enter an Email address for email alerts.
  4. Enter a Phone number for SMS alerts.
  5. Click Add.

Add external contact

The contact is added to the current alert channel. If you need to reuse the same people across several rules, create a recipient group instead.


Save and Verify

  1. Review the Source, Condition, and Alert cards.
  2. Click Save.
  3. Return to Rules.
  4. Confirm the rule appears in the list with the expected status, severity, channel, and tags.

After saving, open the rule detail page to review the complete configuration.


Alternative Starting Points

You can also open the rule editor from an existing source context:

  • Inventory → Function Blocks
  • Inventory → Function Block Sets
  • Charts
  • Dashboards

The source is preselected when Exosphere can identify an eligible alert source. See Create Alerts from Existing Views.