Managing Alerts
Catapult is designed to send you precisely the alerts you want in real time. In order to achieve this, there is an initial investment required setting up your alerts.
When you add a device, the device appears on the My Devices page. Opening the device by clicking its name reveals the following alerts:
- Aggregate Event - Indicates a change in the current tag list of a device. For example, if a door is opened and an RFID tagged item, is removed, this alert will indicate that 1 item has been removed. Catapult will not include details about which tags or items were removed or added in the alert.
- Object Event - Generated by a device when it boots up, once a day, and other various conditions. The alert will contain the total number of items that were seen at that time
- Sensor Reading Event - Includes readings from all the sensors a device is equipped with.
Device Type | Sensors |
|---|---|
Fridges, Freezers, Cabinets | Temperature |
Handhelds, Trays | None |
Mobile Cases | Signal Strength Battery Level Temperature Latitude Longitude Range |
- Heartbeat Event - Typically generated once an hour by a device indicating it is still communicating. However, this is configurable by the device owner which may result in more or less frequent alerts
- Missing Communication - A Missing Communication alert occurs when a device has not communicated for a number of hours. This may be due to power loss at its location, poor internet connection, or some other situation. The hours field is set to 0 by default. This disables the alert from being ever sent. To enable this alert, enter the number of hours the device can be out of communication before the alert is sent. For example, consider the following scenario. The value for a device has been set to 8. A device last communicated at 10am. If no communication is seen after 6pm, the alert would be sent. However, if the device starts communicating at 4pm, the 8 hour timer would be reset.
Device Types | Missing Communication Recommendation (hours) |
|---|---|
Fridges, Freezers, Cabinets, Surface Read Points | 2, because these devices should communicate hourly |
Mobile Cases | 25, because these devices should communicate at least nightly |
Handhelds | none, because communication is dependent on users and does not happen at a regular interval |
- Communication Restore - Occurs when a device re-establishes connection after a Missing Communication alert has been sent. Therefore, a missing communication alert must be set up for the device in order to receive communication restore alerts.
- ACPowerFailure - Occurs when a device loses its AC power connection and is running on internal battery back up.
- ACPowerRestore - Occurs when a device has its AC power connection restored.
- Temperature - Occurs when a device goes outside of its set temperature thresholds, either high or low. However, temperature thresholds can be set by the device owner to values that would never occur, such as 100°C, thus resulting in you receiving no alerts.
- TemperatureRestore - Occurs when a device returns back to within temperature thresholds, either high or low. However, temperature thresholds can be set by the device owner to values that would never occur, such as 100°C, thus resulting in you receiving no alerts.
To enable, simply click on a gray email icon, which will color when enabled.
We strongly suggest always configuring an alert for the following events, since these will typically only alert when an action should be taken to preserve the function of the device and the integrity of its inventory:
- Missing Communication (set hours according to the table above)
- Communication Restore
- ACPowerFailure
- ACPowerFailureRestore
- Temperature
- TemperatureRestore
To disable alerts, simply click on the enabled email icon, which will turn gray when disabled.
The "Last Occurrence" column displays the last time that an alert was sent.
If the device experienced the event, but no alerts were configured to be sent, the "Last Occurrence" column will not be updated. It is the last occurrence of an alert, not necessarily the event itself.
At the bottom left of a device's alerts, there is a box where additional device events can be added and have alerts configured for them. There is no limit to the number of LogEntryEvents you can add.
The additional events you can receive alerts for is highly dependent on the device type. Go to the Jetstream device documentation (linked below) for your device type and browse the LogEntryEvents section to discover which LogEntryEvents your device might send.
Let's say you have reviewed the additional LogEntryEvents for your Terso RFID Freezer and determined you want an email alert when the DoorOpen event occurs, so you can quickly close the door and preserve product integrity.
- On the My Devices page, open the device you wish to add an alert for.
- Enter the LogEntryEvent name exactly in the field at the bottom left. It is case sensitive.
- In this example: "DoorOpen"
- The new event now is added as a row can have Email alerts set for it
In this example, you should also add the "DoorOpenRestore" event and set an alert for that as well, to 'close the loop' when the issue is resolved.