Skip to main content

Alarms

The Cordatus Alarm System allows users to receive notifications through their selected notification channels when specific conditions they set are met. There are two types of alarms in Cordatus:

  1. Model-Based Alarms: Set during model or pipeline deployment.
  2. Analytic-Based Alarms: Defined with analytics while the application is running. This allows alarm creation using analytics rules and model labels.

Setting an Alarm​

Model-Based Alarms​

Model-based alarms are defined independently of jobs and stored separately on the Alarms page. When starting a job, you can select any model-based alarm that is compatible with the job.

Setting a Model-Based Alarm​

To add a model-based alarm, follow these steps:

  1. Go to the Alarms > List page from the left menu.
  2. Make sure you are on the Inference Alarms tab. All your model-based alarms will be listed on this page.
  3. Click the New Inference Alarm button. The New Inference Alarm modal will open.
  4. Alarms can be added in two steps. The first step covers model and alarm information. The second step covers defining alarm rules.

5. Alarm Information:

FieldDescription
NameGive your alarm a name.
Alarm ChannelsSelect from channels added to the notification channels tab. When the alarm condition is met, the user will receive a notification from the selected channel or channels. See the Notification Channels section for details.
Alarm TypeSelect the model type to create an alarm: pipeline or model.
Model (Pipeline) NameSelect a model or pipeline to add an alarm to. The alarm will be available for the selected models or pipelines.
Alarm Message (Optional)This message will be included in the notification message sent through the notification channel.
  • Click the Continue button to proceed to the next step.

6. Alarm Rules:

  • Rules Operand: Select And or OR when adding multiple rules.
  • Select a model or pipeline from the dropdown menu for your alarm.
  • Click Add Single Rule or Add Group Rule to add single or group rules for your alarm.
  • In the added row, select appropriate options or enter values for your alarm.

There are two options:

OptionDescription
Frame BasedTriggered when the selected class reaches the desired number in a single frame.
Time-BasedTriggered if the selected class reaches the desired number within/during the specified time.
  • To add another single or group rule, select the model again for your alarm and click Add Single Rule or Add Group Rule. The new rule will follow the Rules Operand selected in the first stage of step 6.
  • Click the Save button to complete the alarm addition process.

Activating/Deactivating Model-Based Alarms​

We defined the alarm, but it needs to be applied to a job. You can apply model-based alarms during the job startup process.

To activate a model-based alarm, follow these steps:

  1. Open the model deployment modal. See the Jobs section for detailed instructions.
  2. Before starting the model, open the Add Alarm section.
  3. Alarms: Select the alarm you want to add.
  4. Cameras: Select the cameras where the alarm should be applied. The alarm will be triggered when the specified event occurs on the selected camera(s). You can select multiple cameras if needed.
  5. Click the Add button.
  6. After all alarms are set, click Start Job to proceed with model or pipeline deployment.
  7. You can check the status of your alarm on the job's Stream Details page. Click the Alarm icon on the right side of the stream window and toggle the button to activate or deactivate your alarm.

NOTE: You can set multiple model-based alarms for each job.

Editing and Deleting Model-Based Alarms​

To delete an unused Model-Based Alarm:

  1. Go to the Alarms page from the left menu in the Web App.
  2. Make sure you are on the Inference Alarms tab.
  3. Click the gear icon at the end of the desired Model-Based Alarm row.
  4. Select Edit to edit the selected device alarm, or Remove to remove it.
  5. You can also use the eye icon to view the Model-Based Alarm.

Deleting Device Alarms

Analytic-Based Alarms​

Analytic-based alarms are based on analytics rules added during the job's runtime. They make it possible to set alarms based on object behaviors; for example, an alarm is triggered when a person crosses a defined virtual line (created using a line crossing analytics rule). See the Analytic Rules section for more information.

To add an analytic-based alarm after drawing analytics in the Add Analytic modal, follow these steps:

  1. Click the Add Alarm button. The Add Alarm section will appear.
  2. Alarm Name: Give your alarm a name.
  3. Alarm Channels: Select from channels added to the notification channels tab. When the alarm condition is met, the user will receive a notification from the selected channel or channels. See the Notification Channels section for details.
  4. Alarm Message (Optional): This message will be included in the notification message sent through the notification channel.
  5. In the Alarm Rule section, select And or OR as Rules Operand when adding multiple rules.
  6. Select an analytic from the dropdown menu for your alarm drawn in the previous section.
  7. Click Add Single Rule or Add Group Rule to add single or group rules for your alarm.
  8. In the added row, select appropriate options or enter values for your alarm.

Here, rules are created as sentences:

  • Line Crossing Detection: If [class] crosses [rule name] [number of occurence] times.
  • Direction Detection: If [number of occurence] [class] moves towards [rule name] direction.
  • ROI Detection: If [class] detected [number of occurence] times within [rule name] ROI.
  1. To add another single or group rule, select the analytic again for your alarm and click Add Single Rule or Add Group Rule. The new rule will follow the Rules Operand selected in the first stage of step 5.
  2. Click the Save button to complete the alarm addition process.
  3. To check and change the status of your alarm, click the Alarm icon on the right side of the stream window and toggle the button to activate or deactivate your alarm.

INFO: For the ROI Filtering alarm to be re-triggered, the number of objects in the area must fall below the set value and then exceed it again. To give an example, if the alarm is set for detecting 5 vehicles in an area and an alarm has been triggered, the next alarm will only be triggered if the number of vehicles in the area falls below 5 and exceeds it again.

Adding an Alarm to an Existing Analytics Rule Later​

If you want to add an alarm to an existing analytics rule later, please follow these steps:

  1. Go to the Jobs page from the left menu in the Web App.
  2. Click the Show Stream Details icon at the end of the desired job row to go to the Cameras page to view the selected job's stream.
  3. Click the Enlarge icon in the upper right corner of the stream.
  4. Click the purple Add Analytic Rule icon at the top.
  5. Select the analytic type of the analytics rule you want to add an alarm to from the dropdown menu.
  6. Under the Added Analytics label, click on the analytics rule you want to add an alarm to.
  7. Click the green Add Alarm button at the bottom right. The Add Alarm section will appear.
  8. Alarm Name: Give your alarm a name.
  9. Alarm Channels: Select from channels added to the notification channels tab. When the alarm condition is met, the user will receive a notification from the selected channel or channels. See the Notification Channels section for details.
  10. Alarm Message (Optional): This message will be included in the notification message sent through the notification channel.
  11. In the Alarm Rule section, select And or OR as Rules Operand when adding multiple rules.
  12. Select an analytic from the dropdown menu for your alarm drawn in the previous section.
  13. Click Add Single Rule or Add Group Rule to add single or group rules for your alarm.
  14. In the added row, select appropriate options or enter values for your alarm.

Here, rules are created as sentences:

  • Line Crossing Detection: If [class] crosses [rule name] [number of occurence] times.
  • Direction Detection: If [number of occurence] [class] moves towards [rule name] direction.
  • ROI Detection: If [class] detected [number of occurence] times within [rule name] ROI.
  1. To add another single or group rule, select the analytic again for your alarm and click Add Single Rule or Add Group Rule. The new rule will follow the Rules Operand selected in the first stage of step 5.
  2. Click the Save button to complete the alarm addition process.
  3. To check and change the status of your alarm, click the Alarm icon on the right side of the stream window and toggle the button to activate or deactivate your alarm.

Deleting Analytic-Based Alarms​

To delete an Analytic-Based Alarm:

  1. Go to the Jobs page from the left menu in the Web App.
  2. Click the Show Stream Details icon at the end of the desired job row to go to the Cameras page to view the selected job's stream.
  3. Click the Enlarge icon in the upper right corner of the stream.
  4. Click the Alarms icon in the left pane to open the Alarms tab.
  5. Click the gear icon at the end of the desired Analytic-Based alarm row and click Remove.
  6. Finally, click the Yes, delete button to confirm deletion of the selected alarm.

Copyright © 2025 Cordatus.