Alert Event

When an alert is raised, a particular Iotellect Server event is generated in the Alert context, called "Alert Event" or "Alert Instance", which has several uses:

  • Until an “Alert Event” event is acknowledged, it is a "pending alert instance". When an alert has pending instances, the alert itself is put into the Active state. Its icon changes to . This is similar to how many email clients work; the mailbox is highlighted as "Unread" if it has any unread messages in it.

  • History of the “Alert Event” helps to keep track of when and why the alert was raised.

When you View Pending Alerts, you are actually looking at the history of all Alert Events for a particular alert. You can only access this action if the Allow Pending Alerts setting is enabled for this alert.

Format of Alert Event:

Field

Description

Alert Name

Name of alert context.

Alert Description

Description of alert context.

Context

Path of context for which the alert was raised, i.e. context where event or state change monitored by alert trigger has occurred.

Entity

Ether “Event” or “Variable”, indicating if the alert was raised by an event trigger or variable trigger.

Cause

Textual description of the alert's cause.

Message

Alert message. This is a manually configured string, which is displayed in the interface and is assumed to be a human-readable description of the alert (i.e, "The house is on fire"). See the Alert Configuration section.

Trigger

Trigger message. Additional text message provided by alert trigger.

Alert Data

Data associated with the event causing the alert. This field is NULL (not defined) if the alert was caused by a certain variable state or by a variable value change. For a login event defined in the Users context, this data table will contain one record with two fields: Username and Permissions.

Duration

Alert duration. Has zero value if the alert is still active. Filled on alert deactivation by updating a historical alert event stored in the database.

Acknowledgements

Acknowledgements of the event.

Enrichments

Enrichments of the alert.

The technical description of the alert event is available in the context reference section.

Was this page helpful?