To add an iOn alert, you have two options: duplicating (and modifying) an existing alert or creating a new one from scratch. Duplicating an alert is recommended because it is faster, but either method will work. Both are covered below, in separate sections.

 

Skip down to "Creating a New Alert from Scratch" if you are adding an all-new alert.


Note: If you need the alert to be triggered and sent only during a certain portion of the day (for example, if you want to be notified about excessive idling only during the workday), it will need to have a schedule. Make sure to create that schedule before adding your new alert, if it doesn't already exist, following the steps in Adding a Schedule. You can also be alerted when activity occurs outside of the hours in the applied schedule.
 

For an explanation of the features of the Admin - Alerts screen, go to Navigating the Admin - Alerts Screen.


Duplicating an Alert 


First, find an alert whose settings are similar to those of the new alert you need to add. Then follow these steps:


  1. Click  >> Admin >> Alerts.
     
    The Admin - Alerts screen will appear and display the Manage Alerts list.
       
  2. If the alert you want to duplicate is in a subgroup of the one you have selected in the Group Chooser, click Include Subgroups at the bottom of the screen.
     
  3. Scroll down to the alert you need to copy or filter the Name column to find it. (See Sorting and Filtering Column Data if needed.)
     
  4. In the row of the alert, click  under Actions.
     
    The Add Alert dialog box will appear with certain settings of the original alert applied.
       
  5. Type the name to use for the new alert in the Alert Name field.
    Note: For example, you might create an alert called Restricted Zone Alert, which will inform you if one of your operators is driving an asset through a map area you have designated as off-limits (perhaps due to hazardous road conditions).
  6. If you would like to place the alert in a different group than the original, click the Group drop-down arrow and select the group from the list.
    Note: Only assets in the group you choose will trigger the alert you configure, plus its subgroups if you make the alert inheritable. If you want the new alert to be activated by all your assets, place it in your top-level group (and select Inheritable).
  7. To choose a different type of alert, click the Alert Type drop-down arrow and select one of the following values, depending on what you want the alert to be triggered by:
     
    • iOn Event: The event you specify will activate the alert for all assets in the assigned group.
       
    • iOn Event by Asset: The event you specify will activate the alert for only the asset you choose.
      Note: In order to use an alert to monitor one particular asset in this way, you must select the same group in step 6 that the asset is assigned to.
    • iOn Geofence Event: The alert will be triggered if any asset in the assigned group enters or exits the selected landmark's geofence.
       
    • iOn Geofence Event by Asset: The alert will be triggered if the particular asset you indicate enters or exits the selected landmark's geofence.
      Note: As with iOn Event by Asset, this alert type requires you to select the same group in step 6 that the asset is assigned to.
    • iOn DTC Alert: If a diagnostic trouble code (DTC), or fault code, is sent to iOn from an asset in the specified group, it will set off this alert.
       
    • iOn MIL Status Alert [JBUS]: If the malfunction indicator lamp (Check Engine light) code is sent to iOn from a JBUS asset in the specified group, it will set off this alert.
       
    • iOn MIL Status Alert [OBD]: If the malfunction indicator lamp (Check Engine light) code is sent to iOn from an OBDII asset in the specified group, it will set off this alert.
       
    • iOn Speed Alert [PSL]: This is triggered if a vehicle in the assigned group travels the amount you specify over the posted speed limit.
       
    • iOn Speed Alert: This is triggered if a vehicle in the assigned group travels at the speed you specify.
       
    • iOn Maintenance Due Alert: This alert is sent out when an asset in the chosen group comes due for repairs.
      Note: This and the following alert type require service schedules to be set up and assigned to your assets. (See The Process of Creating a Service Schedule and Adding a Service Schedule for details.)
    • iOn Maintenance Alert: You can set this alert to be triggered both when an asset's service reminder time frame starts and on the day (or mile, or hour) it is due for repairs.
       
    • iOn Associated Tag Missing Alert: An alert is sent out if an asset in the group has an associated iOn Tag (see Employing iOn Tags) that is no longer in proximity to the asset's LMU. (In other words, the associated tag is missing.)
       
    • iOn Missing Tag Alert: An alert is sent out if any iOn Tag (see Employing iOn Tags) in the group is no longer in proximity to one of the assets' LMUs (that is, missing).
       
    • iOn Event v2: As with iOn Event, the event you specify will activate the alert for all assets in the assigned group, but this also allows you to narrow the triggering event by asset type, category, name, and route.
       
    • iOn Geofence Event v2: As with iOn Geofence Event, the alert will be triggered if any asset in the assigned group enters or exits the selected landmark's geofence, but this also allows you to narrow the activation by asset type, category, name, and route, plus landmark category. You can choose to monitor just arrivals or departures or both.
       
    • iOn Tag Found Alert: An alert is sent out if any previously missing iOn Tag (see Employing iOn Tags) in the group has been found — that is, it is again close to one of the assets' LMUs.
       
    • iOn Associated Tag Found Alert: An alert is sent out if an asset in the group previously had a missing associated iOn Tag (see Employing iOn Tags) and that tag has now been found — that is, it is again close to the asset's LMU.
       
    • iOn Event Code: As with the iOn Event alert type, the event you specify will activate the alert for all assets in the assigned group, but this differs in that you can specify nonstandard events.
       
    • iOn Device Input X Alert: An alert will be triggered when the specified input is activated (given choices Input 1, Input 2, and so on).
       
  8. If the alert should be triggered and sent only during a certain portion of the day, click the Schedule drop-down arrow and select the name of the schedule.
    Note: You will only be able to apply schedules in the same group as the alert (or a schedule from a parent group that is inheritable).
     
    As mentioned earlier, you should create the schedule before you add the alert. See Adding a Schedule for details.
  9. If the alert should be triggered and sent during the exact opposite segment of the day from the schedule, click the Schedule Reference drop-down arrow and select Outside Schedule.
     
    Normally, you will leave this at its default setting of Inside Schedule, which means that the alert is sent out during the hours set by the schedule.
    Note: Outside Schedule was designed primarily for customers who wanted to make sure that their drivers weren't operating their vehicles outside of their authorized work schedules. You could create such an alert as follows: 
     
    1. Name the alert "Unauthorized Vehicle Use."
       
    2. Set the alert type to iOn Event.
       
    3. Apply the operators' or assets' work schedule (such as 9:00 a.m. to 5:00 p.m.) to the alert — when your vehicles are authorized to be in use.
       
    4. Select Outside Schedule.
       
    5. Later in the process of steps, set the trigger to Ignition On.
       
      This will trigger the alert whenever your drivers use your vehicles after 5:00 in the evening up until 9:00 in the morning (in this example).
  10. Type an explanation of what the alert is designed to inform the user about in the Description field (such as "Vehicle driving in restricted zone").
     
  11. To change the priority level of the alert, click the Severity drop-down arrow and select Low, Medium, High, or Critical.
     
  12. If the Status field isn't set to Enabled, click its drop-down arrow and select that.
    Note: If the alert is set to Disabled or Suspended, its triggering event won't be looked for, and the alert won't be reported to iOn. But this won't likely be what you want when you are adding a new alert.
  13. If you want the alert to be triggered by assets in subgroups of the group it is assigned to (so the subgroups, or child groups, inherit the alert from the parent group), make sure that Inheritable is selected.
     
    If you want it to be sent out only for that single group's assets, deselect Inheritable.
     
  14. Set the triggering event as follows, depending on the type of alert you selected:
     
    • iOn Event: Click the Event Code drop-down arrow and select the name of the event to activate the alert.
        
    • iOn Event by Asset: Search for the individual asset you want to set off the alert by typing part of its name in the Asset Name field and select it from the results.
       
      Then click the Event Code drop-down arrow and select the name of the event to activate the alert.
       

      Note: The Asset Name search will return results only for assets in the same group as the alert.
    • iOn Geofence Event: Click the Geofence Name drop-down arrow and select the name of the landmark that will activate the alert if assets in the assigned group enter or exit its geofence. (Alternatively, you can search for the landmark and select its name from the resulting list.)
       
      Caution: If you chose a different group in which to place the alert than the one you have selected in the Group Chooser, you may need to wait a minute for the landmarks assigned to that group to appear in the list. You can only select landmarks that are in the same group.
    • iOn Geofence Event by Asset: Search for the individual asset you want to set off the alert by typing part of its name in the Asset Name field and select it from the results.
       
      Then click the Geofence Name drop-down arrow and select the name of the landmark that will activate the alert if that particular asset enters or exits its geofence. (Alternatively, you can search for the landmark and select its name from the resulting list.)
       
      Note: Both of these searches will return results only for entities in the same group as the alert.
    • iOn Speed Alert [PSL]: In the Amount Over Posted Speed Limit field, type the value over the speed limit you want to set off the alert (such as 10 to trigger the alert at a speed of 65 mph in a 55 mph zone).
        
    • iOn Speed Alert: In the Speed field, type the speed at which you want to set off the alert (such as 65 to trigger the alert if an asset in the group travels 65 mph or over).
        
    • iOn Maintenance Due Alert: Select the Next Service Due Flag check box if you want an alert to be sent out when an asset in the chosen group comes due for repairs.
        
    • iOn Maintenance Alert: Select the Next Service Reminder Flag check box to have the alert sent out when an asset's service reminder period begins; you can also select the Next Service Due Flag check box to send a second notification on the day, mile, or hour the service is due. You can ignore the Next Service Days Overdue, Next Service Odometer Overdue, and Next Service Engine Hours Overdue fields.
         
    • iOn Event v2: Click the Event Code drop-down arrow and select the name of the event to activate the alert; this is the only required attribute. But you can narrow the alert activation further by filling in the other fields. If applicable, click the Asset Type, Asset Category, Asset Name, and Route drop-down arrows and select in each what you want to trigger the alert.
        
    • iOn Geofence Event v2: Click the Geofence Name drop-down arrow and select the name of the landmark that will activate the alert if assets in the assigned group enter or exit its geofence (or both, as you choose). You can narrow the alert activation further by filling in the other fields. If applicable, click the Asset Type, Asset Category, Asset Name, Route, Geo Event Type, and Geo Landmark Category drop-down arrows and select in each what you want to trigger the alert.
        
    • iOn Event Code: Type the name of the event to activate the alert.
        
    • iOn Device Input X Alert: Type a name for the input that will be meaningful when the alert is received (so instead of just "Input 1," it will say, "Snow Plow," for example).
        
    • All other alerts: No triggers need to be set for any of the remaining alerts, as any asset in the specified group will generate the alert.
       
  15. Scroll down to the Alert Actions section.
      
  16. To change or add recipients, select or deselect the Email and/or SMS check box; these options have the alert sent to the concerned parties (such as one of your organization's iOn administrators, an operator supervisor, or yourself) by email or text.
     
    Then follow step 17 or 18, respectively.
    Note: You'll have to have at least one email or mobile number set up to receive the alert in order to save it.
  17. For Email, follow these steps:
     
    1. Type (or copy and paste) the first recipient's email address on the To line, replacing or keeping any current emails as needed.
       
    2. If you want the alert to be sent to multiple people, type a comma after the first address and then enter the next recipient's email address (and so on).
       
      You can add carbon copy (CC) and blind carbon copy (BCC) recipients the same way.
       
    3. On the Subject line, select the current email subject text (if any) and type the new one (which could be just the name or description of the alert).
         
  18. For SMS, type the cell phone number of the person you want to receive the text on its To line.
     
    To add multiple people, place a comma after the preceding phone number and then type the next one.
     
  19. Click Save.
       
    Your new alert will appear in the Manage Alerts list.


Creating a New Alert from Scratch


Note: Again, you may find it simpler instead to duplicate an alert, as shown in the preceding section.


To build a completely new alert from the ground up, follow these steps:


  1. Click  >> Admin >> Alerts.
     
    The Admin - Alerts screen will appear and display the Manage Alerts list.
       
  2. Click Add Alert at the bottom of the screen.
     
    The Add Alert dialog box will appear.
       
  3. Type the name to use for the alert in the Alert Name field.
    Note: For example, you might create an alert called Restricted Zone Alert, which will inform you if one of your operators is driving an asset through a map area you have designated as off-limits (perhaps due to hazardous road conditions).
    By default, the group you currently have selected in the Group Chooser will be set for the group to add the alert to.
     
  4. If you would like to place it in a different group, click the Group drop-down arrow and select the group from the list.
    Note: Only assets in the group you choose will trigger the alert you configure, plus its subgroups if you make the alert inheritable. If you want the new alert to be activated by all your assets, place it in your top-level group (and leave Inheritable selected).
  5. Click the Alert Type drop-down arrow and select its type, depending on what you want the alert to be triggered by:
     
    • iOn Event: The event you specify will activate the alert for all assets in the assigned group.
       
    • iOn Event by Asset: The event you specify will activate the alert for only the asset you choose.
      Note: In order to use an alert to monitor one particular asset in this way, you must select the same group in step 4 that the asset is assigned to.
    • iOn Geofence Event: The alert will be triggered if any asset in the assigned group enters or exits the selected landmark's geofence.
       
    • iOn Geofence Event by Asset: The alert will be triggered if the particular asset you indicate enters or exits the selected landmark's geofence.
      Note: As with iOn Event by Asset, this alert type requires you to select the same group in step 4 that the asset is assigned to.
    • iOn DTC Alert: If a diagnostic trouble code (DTC), or fault code, is sent to iOn from an asset in the specified group, it will set off this alert.
       
    • iOn MIL Status Alert [JBUS]: If the malfunction indicator lamp (Check Engine light) code is sent to iOn from a JBUS asset in the specified group, it will set off this alert.
       
    • iOn MIL Status Alert [OBD]: If the malfunction indicator lamp (Check Engine light) code is sent to iOn from an OBDII asset in the specified group, it will set off this alert.
       
    • iOn Speed Alert [PSL]: This is triggered if a vehicle in the assigned group travels the amount you specify over the posted speed limit.
       
    • iOn Speed Alert: This is triggered if a vehicle in the assigned group travels at the speed you specify.
       
    • iOn Maintenance Due Alert: This alert is sent out when an asset in the chosen group comes due for repairs.
      Note: This and the following alert type require service schedules to be set up and assigned to your assets. (See The Process of Creating a Service Schedule and Adding a Service Schedule for details.)
    • iOn Maintenance Alert: You can set this alert to be triggered both when an asset's service reminder time frame starts and on the day (or mile, or hour) it is due for repairs.
       
    • iOn Associated Tag Missing Alert: An alert is sent out if an asset in the group has an associated iOn Tag (see Employing iOn Tags) that is no longer in proximity to the asset's LMU.
       
    • iOn Missing Tag Alert: An alert is sent out if any iOn Tag (see Employing iOn Tags) in the group is no longer in proximity to an asset's LMU.
       
    • iOn Event v2: As with iOn Event, the event you specify will activate the alert for all assets in the assigned group, but this also allows you to narrow the triggering event by asset type, category, name, and route.
       
    • iOn Geofence Event v2: As with iOn Geofence Event, the alert will be triggered if any asset in the assigned group enters or exits the selected landmark's geofence, but this also allows you to narrow the activation by asset type, category, name, and route, plus landmark category. You can choose to monitor just arrivals or departures or both.
       
    • iOn Tag Found Alert: An alert is sent out if any previously missing iOn Tag (see Employing iOn Tags) in the group has been found — that is, it is again close to an asset's LMU.
       
    • iOn Associated Tag Found Alert: An alert is sent out if an asset in the group previously had a missing associated iOn Tag (see Employing iOn Tags) that has now been found — that is, it is again close to the asset's LMU.
       
    • iOn Event Code: As with the iOn Event alert type, the event you specify will activate the alert for all assets in the assigned group, but this differs in that you can specify nonstandard events.
       
    • iOn Device Input X Alert: An alert will be triggered when the specified input is activated (given choices Input 1, Input 2, and so on).
       
  6. If the alert should be triggered and sent only during a certain portion of the day, click the Schedule drop-down arrow and select the name of the schedule.
    Note: You will only be able to apply schedules in the same group as the alert (or a schedule from a parent group that is inheritable).

    As mentioned earlier, you should create the schedule before you add the alert. See Adding a Schedule for details.
  7. If the alert should be triggered and sent during the exact opposite segment of the day from the schedule, click the Schedule Reference drop-down arrow and select Outside Schedule.
     
    Normally, you will leave this at its default setting of Inside Schedule, which means that the alert is sent out during the hours set by the schedule.
    Note: Outside Schedule was designed primarily for customers who wanted to make sure that their drivers weren't operating their vehicles outside of their authorized work schedules. You could create such an alert as follows: 
     
    1. Name the alert "Unauthorized Vehicle Use."
       
    2. Set the alert type to iOn Event.
       
    3. Apply the operators' or assets' work schedule (such as 9:00 a.m. to 5:00 p.m.) to the alert — when your vehicles are authorized to be in use.
       
    4. Select Outside Schedule.
       
    5. Later in the process of steps, set the trigger to Ignition On.
       
      This will trigger the alert whenever your drivers use your vehicles after 5:00 in the evening up until 9:00 in the morning (in this example).
  8. Type an explanation of what the alert is designed to inform the user about in the Description field (such as "Vehicle driving in restricted zone").
     
  9. Click the Severity drop-down arrow and select the priority level of the alert: Low, Medium, High, or Critical.
     
  10. Leave the Status field at its default value of Enabled.
    Note: If the alert is set to Disabled or Suspended, its triggering event won't be looked for, and the alert won't be reported to iOn. But this won't likely be what you want when you are adding a new alert.
  11. If you want the alert to be triggered by assets in subgroups of the group it is assigned to (so the subgroups, or child groups, inherit the alert from the parent group), leave Inheritable selected.
     
    If you want it to be sent out only for that single group's assets, deselect Inheritable.
     
  12. Set the triggering event as follows, depending on the type of alert you selected:
     
    • iOn Event: Click the Event Code drop-down arrow and select the name of the event to activate the alert.
        
    • iOn Event by Asset: Search for the individual asset you want to set off the alert by typing part of its name in the Asset Name field and select it from the results.
       
      Then click the Event Code drop-down arrow and select the name of the event to activate the alert.
       

      Note: The Asset Name search will return results only for assets in the same group as the alert.
    • iOn Geofence Event: Click the Geofence Name drop-down arrow and select the name of the landmark that will activate the alert if assets in the assigned group enter or exit its geofence. (Alternatively, you can search for the landmark and select its name from the resulting list.)
       
      Caution: If you chose a different group in which to place the alert than the one you have selected in the Group Chooser, you may need to wait a minute for the landmarks assigned to that group to appear in the list. You can only select landmarks that are in the same group.
    • iOn Geofence Event by Asset: Search for the individual asset you want to set off the alert by typing part of its name in the Asset Name field and select it from the results.
       
      Then click the Geofence Name drop-down arrow and select the name of the landmark that will activate the alert if that particular asset enters or exits its geofence. (Alternatively, you can search for the landmark and select its name from the resulting list.)
       
      Note: The Asset Name search will return results only for assets in the same group as the alert.
    • iOn Speed Alert [PSL]: On the Amount Over Posted Speed Limit line, type the value over the speed limit you want to set off the alert (such as 10 to trigger the alert at a speed of 65 mph in a 55 mph zone).
        
    • iOn Speed Alert: In the Speed field, type the speed at which you want to set off the alert (such as 65 to trigger the alert if an asset in the group travels 65 mph or over).
        
    • iOn Maintenance Due Alert: Select the Next Service Due Flag check box if you want an alert to be sent out when an asset in the chosen group comes due for repairs.
        
    • iOn Maintenance Alert: Select the Next Service Reminder Flag check box to have the alert sent out when an asset's service reminder period begins; you can also select the Next Service Due Flag check box to send a second notification on the day, mile, or hour the service is due. You can ignore the Next Service Days Overdue, Next Service Odometer Overdue, and Next Service Engine Hours Overdue fields.
         
    • iOn Event v2: Click the Event Code drop-down arrow and select the name of the event to activate the alert; this is the only required attribute. But you can narrow the alert activation further by filling in the other fields. If applicable, click the Asset Type, Asset Category, Asset Name, and Route drop-down arrows and select in each what you want to trigger the alert.
        
    • iOn Geofence Event v2: Click the Geofence Name drop-down arrow and select the name of the landmark that will activate the alert if assets in the assigned group enter or exit its geofence (or both, as you choose). You can narrow the alert activation further by filling in the other fields. If applicable, click the Asset Type, Asset Category, Asset Name, Route, Geo Event Type, and Geo Landmark Category drop-down arrows and select in each what you want to trigger the alert.
        
    • iOn Event Code: Type the name of the event to activate the alert.
        
    • iOn Device Input X Alert: Type a name for the input that will be meaningful when the alert is received (so instead of just "Input 1," it will say, "Snow Plow," for example).
        
    • All other alerts: No triggers need to be set for any of the remaining alerts, as any asset in the specified group will generate the alert.
       
  13. Scroll down to the Alert Actions section.
      
  14. Select the Email and/or SMS check box to have the alert sent to the concerned parties (such as one of your organization's iOn administrators, an operator supervisor, or yourself) by email or text and then follow step 15 or 16, respectively.
    Note: Specifying at least one email or mobile number is required before you can save the alert.
  15. For Email, follow these steps:
     
    1. Type (or copy and paste) the first recipient's email address on the To line.
       
    2. If you want the alert to be sent to multiple people, type a comma after the first address and then enter the next recipient's email address (and so on).
       
      You can add carbon copy (CC) and blind carbon copy (BCC) recipients the same way.
       
    3. On the Subject line, type the email subject text (perhaps just the name or description of the alert).
         
  16. For SMS, type the cell phone number of the person you want to receive the text on its To line.
     
    To add multiple people, place a comma after the preceding phone number and then type the next one.
     
  17. Click Save.
       
    If the group you placed the alert in is the one you have selected in the Group Chooser (or is a child of it and you have Include Subgroups selected), your new alert will appear in the Manage Alerts list.