Getting Started - Events

Keywords: iMonnit, notifications, sensor, sensors, account, battery, calls, voice alerts, voice call, sms, message


Summary:

Getting started guide to adding events on iMonnit.



Description: Events are triggers or alarms set to let you know when a sensor reading identifies that immediate attention is needed. Types of events include sensor readings, battery level, device inactivity, and scheduled data. Any one of these can be set to send a notification or trigger an action in the system.  This guide will walk you through creating two types of events.  First a sensor reading notification for a temperature sensor, then an inactivity notification configured for all sensors.

  • Open iMonnit®.

  • Select "Events" in the main navigation menu.


  • A list of previously created events will display on the screen. From here, you have the ability to filter, refresh, and add new events to the list. 


Note: If this is your first time adding an event the screen will be blank.

Adding Events

  • From the Events page, tap "Add Event" in the left hand corner.


  • The dropdown menu will have the following options for Event Types:


    • Sensor Reading:  Set alerts based on sensor activity or reading.

    • Battery Level: This is where you can set to be notified when the battery level drops below a certain percentage. 15% is the default setting.

    • Device Inactivity: Alerts when the device doesn't communicate for an extended period of time.

    • Advanced: Alerts based on advanced rules, such as comparing past data points with current ones.

    • Scheduled: These are notifications that fire at a time set basis

Creating a Sensor Reading Event

  • Select Sensor Reading from the drop-down menu.

  • A second drop down menu will appear. From here, you'll be able to see a list of the different type of sensors registered to your account. Choose Temperature in the drop-down menu. 

  • Next, you'll be asked to input the trigger settings. You have the option of setting this trigger for greater than or less than a temperature reading.

  • Press the "Save" button.

If you don't have a temperature sensor, the option in this example won't be available. select any variable output sensor and follow along. 

Variable output sensors can have multiple events triggers created.

Example: A temperature sensor used in a freezer. You may want to be notified if the temperature goes below 0° or above 30° Fahrenheit. You would create two events.

  • Event 1-Trigger Set for temperatures LESS THAN 0° F.

  • Event 2-Trigger set for temperatures GREATER THAN 30° F.

 
Completing Event Trigger Configuration

The Event Information page has a series of tabs across the top.

  1. History: A table of all past alert notifications for this specific event.

  2. Schedule: Here you can schedule the event only to be active at certain times or certain days.

  3. Trigger: This is where you can review your trigger settings.

  4. Actions: Where you set the action you want to happen when an alert state is triggered.

Selecting Event Trigger Sensors
  • Choose the Trigger tab. 

  • The Trigger Sensors section sits below Trigger Conditions. If you have multiple sensors for the same type (Example: five Temperature sensors), this is where they will be listed. There should be at least one sensor in this section. 

  • By default, the sensor(s) will not be assigned to the event conditions you've just set. To assign a sensor, find the device(s) you want to designate for this event and select. Selected sensor boxes will turn green when activated. Choose the sensor box again to unassign the sensor from the event. 

  • Continue toggling the sensor(s) corresponding this new event until you are satisfied with your selection. These can be adjusted later by returning to this page. 

  • Press the "Save" button. 

Configure Event Action: Send Notification

To link a notification action to the trigger you have created:

  • Select the Actions tab.

  • Click the Add Action button under the Event Information header and available action types are presented in a select list.

    • Notification Action: Specify account users to be receive notification when this event triggers.

    • System Action: Assign actions for the system to process when this event triggers.

  • Choose Notification Action from the select list


  1. Configure the Subject for the notification

  2. Customize the Message body for the notification

  3. Save button commits any changes to message content fields.

  4. Recipient list identifies who will receive the notification

    • Click the icon next to a user to configure how they will be notified.

    • Choose if you want notifiation sent immediatly when triggered or if you want a delay before it is sent and press Set.

    • A green icon indicates the users that will receive the notification.

    • A gray icon indicates the users that will not receive the notification.

    • If a delay has been selected, the delay time will display beside the icon.

 
Configure Event Action: System Action
To link a system action to the trigger we've created:
  • Select System Action from the select list under the Event Information header.

  • Scroll down to the System Action section.

  • The Action to be Done select list has the following options.

    • Acknowledge: Automatically acknowledge an event. When an event is triggered, actions will continue processing until the event is acknowledged or the temperature returns to a value that no longer triggers the event.

    • Full Reset: Reset your trigger so it is armed for the next reading. 

    • Activate: Enable an event trigger.

    • Deactivate: Disable an event trigger.

  • Select the Add button.

 

Creating a Device Inactivity Event. 

  • Select Device Inactivity from the drop-down menu.

  • Set the time threshold you want to be notified after the sensor has been silent. 60 minutes is the default. So if the system has not received a message from the triggering device for more than one hour, this event trigger will fire.

Note: It is recommended to set inactivity threshold for gateways at a minimum of twice the configured heartbeat of the gateway. For sensors it is recommended to set the inactivity threshold at twice the heartbeat of the sensor plus the heartbeat of the gateway. This will help keep your inbox free from false triggers.

  • Pressing "Save" will guide you to the Event Information page. 

  • Select the Trigger tab. 

  • Find your sensor list and choose the sensor(s) you want to assign to this event. 

  • Press the "Save" button. 

  • Select the Actions tab.
  •  Assign Notification Actions or System Actions as you did above.

 

 

You have created some Events, by defining triggers and assigning actions! Repeat the process above to add additional events.



Related Articles