Ir para o conteúdo principal
CloudStudio

Alerts and Alarms

The Gear Studio platform allows you to define alerts that trigger when the values of certain variables exceed defined thresholds. Alarms, on the other hand, are conditions that indicate a problem and can occur for different reasons, including alerts. In other words, alerts generate alarms when measured values fall outside established thresholds, but alarms can also be generated for other reasons, such as device malfunctions, connection errors, etc.

Alerts

Alerts are applied to endpoints and allow you to define acceptable value ranges so that alarms are automatically generated when values fall outside these thresholds. To set up an alert, use the alerts screen, where you select the alert type, the endpoint it will apply to, the threshold value, and optionally, a minimum duration the condition must persist before the alert generates the corresponding alarm.

Normal Value

It is also possible to define a second threshold for the alert to clear. This allows establishing a hysteresis value to prevent the alert from triggering frequently when the endpoint value fluctuates near the threshold. For example, you can set a high temperature alert with the threshold at 60 degrees and a normal threshold of 55. This will cause the alert to trigger when the value exceeds 60 degrees and clear only when the temperature drops to 55 degrees. The alert will remain active from the time the temperature exceeds 60 degrees until it drops to 55.

Alert Severity

Severity levels in alerts indicate the criticality associated with alarms. Severity levels can be information, low, medium, or high as shown in the following image:

New alert form with the severity level dropdown: information, low, medium or high

Important

By default, an alarm will be created with the "Low" value. If an alert is created with a severity level of "High", for example, and that alert is subsequently triggered, the alarm history report will retain the severity level with which it was created, even if the severity level was later modified through the alert settings.

Available Alert Types

The following are the alert types available on the platform, with a brief explanation of each.

VariableConditionSupports normal thresholdSupports minimum duration
TemperatureHigh or lowYesYes
HumidityHigh or lowYesYes
Light levelHigh or lowYesYes
VolumeHigh or lowYesYes
WeightHigh or lowYesYes
PressureHigh or lowYesYes
VoltageHigh or lowYesYes
CurrentHigh or lowYesYes
Active powerHigh or lowYesYes
Reactive powerHigh or lowYesYes
Apparent powerHigh or lowYesYes
Cosine phiHigh or lowYesYes
IAS sensorActivated or deactivatedNoYes
Generic variableHigh or lowYesYes

Alert Configuration

Alerts are applied to endpoints and allow you to define acceptable value ranges so that alarms are automatically generated when values fall outside these thresholds. To set up an alert, use the alerts screen, where you select the alert type, the endpoint it will apply to, the threshold value, and optionally, a minimum duration the condition must persist before the alert generates the corresponding alarm.

Users can use all available variables that have been enabled in their instance and can also customize alert subjects.

For additional information about the allowed variables, click here

Add alert form with the Details tab, conditions and severity level

These are the allowed parameters (Variables):

VariableComments
{CLIENT_ID}Unique client identifier
{CLIENT_NAME}Client name/description
{FACILITY_ID}Unique facility identifier
{FACILITY_NAME}Facility description
{DEVICE_ID}Unique device identifier
{DEVICE_NAME}Device description
{ENDPOINT_ID}Unique endpoint identifier
{ENDPOINT_NAME}Endpoint description
{DEVICE_OR_ENDPOINT_NAME}Endpoint description. If not valid, the device description will be shown.
{ALARM_TEXT}Alarm description
{ALARM_DETAILS}Alarm details

Alarms

Alarms are triggered automatically when problems are detected with devices, endpoints, alerts, or any other anomalous situation. The most common alarm types are shown below.

Alarm typeComments
Device offlineTriggered when a device does not communicate with the platform after a certain time. The maximum time a device can go without sending information to the platform is set in each device model.
AlertTriggered when an alert indicates that an endpoint value is outside the defined thresholds. For each alert type, there is a corresponding alarm type, for example, high temperature alarm, IAS sensor activation alarm, etc.
Low batteryTriggered when a device's battery level is low.
Critical batteryTriggered when a device's battery level is critical.
Overheating condition. All outputs turned offThis alarm type is not yet implemented
Low temperature conditionThis alarm type is not yet implemented
Charging failureThis alarm type is not yet implemented
Informational messageThis alarm type is not yet implemented
Unspecified or generic messageThis alarm type is not yet implemented

Última atualização em

Nesta página