Automatically Email Alarm Notifications

Automatically Email Alarm Notifications

You can use DataSight to automatically email an Alarm notification either when no data has been received or as defined by the severity levels in an Alarm calculation template.

Once an Alarm Task executes, and the trigger conditions have been met, an email notification is issued.

By default, an Alarm Task will issue an email notification upon every activated Alarm execution. This behaviour can be configured so that subsequent notifications are only sent after a set number of task executions (iterations) have occurred.

Specifically, to configure an Alarm Task you will need to set:

  • how often the Task is executed.
  • how often to re-send the email notifications.
  • a reset period for clearing the alarm after it is no longer active, and before a new alarm is generated.

 

To coordinate notifications, DataSight Alarm Tasks log the Date and Time of the Alarm sent, and categorises the Alarm Event as follows:

Alarm Event

Alarm Severity

Not Active

Alarm conditions not met

Active/Resend

Alarm conditions met/Resend if specified

Upgrade

Alarm Severity level has increased

Downgrade

Alarm Severity level has decreased

Inactive

Alarm conditions not met/Inside clearance period

Clearance

Alarm conditions not met/End of clearance period

An email notification is sent when the Alarm transitions between Alarm Severity levels, regardless of the notification re-send period.

You can also define a reset period (in minutes) after which the Alarm is cleared.

email_alarm_calc_flow.png

The email notification issued by the Alarm Task will contain specific information in the Email Subject Line and Body.

 

The Subject line will contain combinations of the:

  • Alarm Event
  • Alarm Name, as defined by the Alarm calculation template's Alarm Severity, in brackets.
  • Level 3 name the alarm relates to.

 

The Email Body will contain the following (applicable) information:

  • A summary header row, notably highlighted with the currently active Alarm Severity's assigned colour.
  • Level 3 name the Alarm relates to.
  • Date and Time the email notification was issued.
  • Alarm Name, as defined by the Alarm calculation template's Alarm Severity.
  • Variable being monitored, its Value and Units of measurement.
  • Variables and References used in the Alarm calculation template, as well as their Values.
  • Date and Time the Alarm was originally triggered at, as well as the monitored Variable's value at that point in time.

 

Send an Email Alarm Notification

  1. With Tasks open in the main panel, click New on the DataSight Quick Access Toolbar. The task selection window will appear.
  2. Type in a Description for the task. This will identify the task to everyone.
  3. Select the Alarm task type.
  4. Select either Alarm if NO DATA or ALARM based on Calculation Result for the Alarm Activate Condition.
  5. Select a Saved View datasheet from the Filter From drop down list.
  6. Select a saved calculation template from the Calculation drop down list. A calculation template will only be displayed in the drop down list if Alarm has been selected as the calculation template's Output.
  7. (Optional) Enter the Resend email every # iterations The time in brackets will be updated to reflect when the next email notification will be issued based on the number of iterations and the Task recurrence period values you have entered.
  8. (Optional) Enter the reset period for how many minutes must elapse before a new Alarm notification will be issued.
  9. Enter the desired email address in the Recipient(s) To enter more than one email address, separate each address with a comma.
  10. Set the Recurrence interval over which you wish the report to run.
  11. (Optional) To add sub tasks, click Add Sub Tasks (See Add Sub Tasks for more details).
  12. Click OK.
  13. Remember to click Save in the Quick Access Toolbar to save the entire Task set, prior to closing the Tasks grid view.

Note

Ensure the user has entered the correct email server (SMTP) details in the DataSight Service Manager.

Email addresses must be separated by a comma, otherwise only the first recipient will receive the email with the other recipient email addresses being ignored.

There is no need to define the email Subject or Body as these are automatically set by the Alarm Task.

 

See also:

  • Alarm Severity
  • Alarm Calculations
    • Related Articles

    • Automatically Email a Message

      You can use DataSight to automatically email a message at some point in the future. From within the Tasks grid view, either double-click on a selected task row, or click on the Edit The Edit Tasks dialogue window appears. Select the Email Message ...
    • Automatically Email Documents

      Documents stored in DataSight can be scheduled for email. This may be of use when you are routinely required to distribute supporting documentation such as methodologies or sampling schedules as saved calendar files. From within the Tasks lgrid view, ...
    • Automatically Export Data

      Automated reporting of a data set in a chosen format can be scheduled using a Saved Datasheet. From within the Tasks grid view, either double-click on a selected task row, or click on the Edit The Edit Tasks dialogue window appears. Choose the Saved ...
    • Automatically Publish Reports

      Automated publication of reports in a chosen format can be scheduled using a Saved Datasheet. From within the Tasks grid view, either double-click on a selected task row, or click on the Edit The Edit Tasks dialogue window appears. Choose the Saved ...
    • Automatically Publish Charts

      Automated visualisation of your data set can be produced in a chosen format using a Saved Chart View. From within the Tasks grid view, either double-click on a selected task row, or click on the Edit The Edit Tasks dialogue window appears. Choose the ...