====== Configuring Sensors ======

===== Navigation =====
Sensor configuration can be accessed from the [[user_manual:dashboard:view_device|Device/Devicepool View]] page. 

===== Overview =====
Here you can configure various sensor details, templates, and rules. Displayed fields may vary based on your user role.  

{{ :user_manual:dashboard:configure_sensors:trait_edit_details.png?400 |}}

==== Editing a Sensor's Name ====
The sensor's name can be edited by changing this field.  

{{ :user_manual:dashboard:configure_sensors:trait_edit_details_-_name_highlight.png?400 |}}

==== Sensor Value ====
Here you can view and edit (where applicable) a sensor's recorded value without formatting.  

{{ :user_manual:dashboard:configure_sensors:trait_edit_details_-_value_highlight.png?400 |}}

==== Editing a Sensor's Template ====
A sensor's template can be changed by selecting an option from the drop-down menu. Templates define how your reading will be displayed on the sensor dashboard, as well as in alert messages.  

{{ :user_manual:dashboard:configure_sensors:trait_edit_template_open_-_template_highlight.png?400 |}}

===== Editing Sensor Rules =====
Alerts can be configured by clicking on the **Rules** tab. Rules can be applied to a sensor to configure the server to dispatch alerts when the specified condition triggers.  
To add a rule, click on the **+** button, then select a rule from the drop-down menu.  

{{ :user_manual:dashboard:configure_sensors:trait_edit_rule_add_-_add_highlight.png?400 |}}

==== Rule Name ====
This affects the name with which the rule will be displayed in the rules field.  

{{ :user_manual:dashboard:configure_sensors:trait_edit_rule_add_top_half_-_name_highlight.png?400 |}}

==== Delay ====
This defines how long the sensor must remain outside of the configured values before an alert will be dispatched.  

{{ :user_manual:dashboard:configure_sensors:trait_edit_rule_add_top_half_-_delay_highlight.png?400&align=center |Rule Delay}}

==== Alert Group ====
This determines the recipients that the alert notifications will be dispatched to.  
Alert groups can be created [[user_manual:alert_groups:create_alert_group_|here]].  

{{ :user_manual:dashboard:configure_sensors:alert_group_.png?400&align=center |Alert Group Example}}

==== Configuration ====
The rule configuration varies per rule. This defines the values which need to be exceeded for an alert to be triggered.  

{{ :user_manual:dashboard:configure_sensors:trait_edit_rule_add_bot_half_-_config_highlight.png?400&align=center |Rule Configuration}}

==== Alert Type ====
A device's alert type can be assigned by selecting an alert type from the drop-down menu. There are currently two types of alerts:  
  * **Board Alerts** – Created when the device itself determines that an alert needs to be dispatched. Some rules and devices, however, do not support board alerts.  
  * **Server Alerts** – Created when the server determines that an alert needs to be dispatched. This is primarily used for rules which aren't supported by the board.  

{{ :user_manual:dashboard:configure_sensors:trait_edit_rule_alert_type_open_-_type_highlight.png?400&align=center |Alert Type}}

===== Editing Alert Schedules =====
Adding alert schedules allows you to define days and times at which you do not wish to receive alerts.  
To configure:  
  - Add a start time and end time into the time fields.  
  - Select a day and press the **+** button.  
  - Created schedules will appear in the field labeled **Off Times**.  
  - **Snooze days** set the entire day as a day on which you do not wish to receive alerts.  

**Example:**  
Your business operates between 08:00 and 17:00. Your fridges are turned off on Friday after business hours. If a rule is set, once the fridges are turned off, you will receive an alert. However, you already expect the temperature to rise since the fridges are off.  

Setting an alert schedule for **Friday from 17:00 to 23:59** and setting **Saturday and Sunday** as snooze days would prevent alerts from being sent out during those times.  

{{ :user_manual:dashboard:configure_sensors:trait_edit_rule_schedules_-_schedule_highlight.png?400&align=center |Alert Schedule}}

===== Verifying Configuration  =====
The bell icon here shows that the alert group has been configured and the screen icon shows that it is a server alert.
{{ :user_manual:dashboard:configure_sensors:server_alert_.png?400 |}}

Here there is no screen icon which mean that it has been set up for a board alert.
{{ :user_manual:dashboard:configure_sensors:board_alert_.png?400 |}}