Creating 'Too long outside geozone' alerts

Create an alert to get notified when an asset remains for too long outside a geozone.

This tasks explains how to create a too long outside geozone alert.

Procedure

  1. Go to Admin → Insights → Alert rules and select .
  2. Select the Rotation alert Too long outside Geozone
  3. Enter a title (name) for the alert rule you create.
    Note: The title is shown to all users receiving the alert notification and consulting the dashboard. Define clear and meaningful alert titles.
  4. Write down a description of the alert rule (optional).
    Note: Although optional, it is recommended to use the description to provide more information the end-users in order to ensure they understand the meaning of the alert rule.
  5. Select the severity level of the alert. Some alerts are more severe then others. You can choose between 'reminder', 'warning' and 'critical'.

  6. Monitored assets defines the assets on which the alert rule will be evaluated. You can select these assets by identifier (name, serial, MAC, IMEI), by tag, or include all assets (all).

  7. Select the geozones and define the timeout period. This is the maximum time an asset may stay outside of the geozones before an alert is raised. Enter the number of days and hours.

  8. Define the application time of the alert rule. Should it Always monitor your assets on any day at any time or do you want it only to be monitoring your assets on certain days? For the second option, select ‘Scheduled’. Here you can select on which days, during what hours. By clicking the button you can add more time periods. To exclude specific days, enable the Exclude specific dates check-box and choose the dates on which the monitoring should be disabled. Clicking the button to add multiple exclusion dates. Additionally, you must define the time zone the platform should use for evaluating the alert schedule. By default the time zone of the current user is selected.

  9. If you want to receive an email or REST notification if the alert is raised do as following
  10. By default, triggered alerts are only shown in the application. To enable the sending of notifications, click the Add notification button.
  11. To enable Email notifications, choose 'Email notification' in the drop-down list and complete the following fields:

    1. Platform users: select the user(s) known by the platform.
    2. Email addresses: enter specific email addresses not associated to platform users. This is useful, for example, to send notifications to distribution list email addresses.
    3. Custom email subject: select the custom email subject check box to define a custom e-mail subject message.
    4. Subject template: Format the custom email subject message text. You can use different fields from the wizard to be used in the message. You can test the template by only entering your email address in the email address section and by clicking the send test email button.
      Example: Alert! {asset_name} has entered {geozone_name} will create following email subject ‘Alert! RTP 743 has entered warehouse Drongen
    5. Click the button.
      The alert rule is immediately active. If alerts are detected, this may result in the immediate sending of the notification emails.
  12. Select 'REST push notification' from the drop-down list.
    The following window appears:

    Fill in the following:

    1. Method: choose between the POST, PUT or GET method.
    2. Callback URL: enter the URL.
    3. Click the Test button to perform a test callback.
    4. Click the button.
      The alert rule is immediately active. If alerts are detected, REST calls may be performed immediately.

Results

From now on the too long outside geozone alert rule is created.