Creating 'Outside geozone' alerts

Create an alert rule to get notified when an asset leaves a geozone.

this task describes the different steps to create a geozone outside alert rule.

Procedure

  1. Go to Admin → Insights → Alert rules and select .
  2. 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.
  3. 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.
  4. Select the severity level of the alert. Some alerts are more severe then others. You can choose between 'reminder', 'warning' and 'critical'.

  5. 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).

  6. Select the geozones for which you want to monitor the activity of your assets. You can select these geozones by name, by geozone tag, or include all geozones. In addition you should define the time period the asset should be in or out the geozone for the alert to be given. Finally, you can choose which event types trigger the alert. For example, you select STOP if you only want to alert to be sent if the asset has stopped. You can select different event types if you prefer.

  7. 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.

If you want to add an e-mail or REST API notification for this alert do as following:

  1. By default, triggered alerts are only shown in the application. To enable the sending of notifications, click the Add notification button.
  2. 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.
  3. 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

The outside geozone alert rule is now created.