librenms-librenms/doc/Support/Device-Sensors.md

source: Support/Device-Sensors.md
path: blob/master/doc/

## Device Sensors 

LibreNMS has a standard for device sensors they are split into categories.
This doc is to help users understand device sensors in general, if you need help with developing sensors for a device please see the Contributing + Developing section. 

### Health Sensors

The High and Low values of these sensors can be edited in Web UI by going to the device settings -> Health. There you can set your own custom
High and Low values. List of these sensors can be found here [Link](../Developing/os/Health-Information.md)

**Note** Some values are defined by the manufactures and others are auto calculated when you add the device into librenms. Keep in mind every environment is different and may require user input.


### Wireless Sensors

Some Wireless have  High and Low values of these sensors can be edited in Web UI by going to the device settings -> Wireless Sensors There you can set your own custom High and Low values. List of these sensors can be found here [Link](../Developing/os/Wireless-Sensors.md)

**Note** Some values are defined by the manufactures and others are auto calculated when you add the device into librenms. Keep in mind every environment is different and may require user input.

### State Sensors

Return states of device entries sensors states. For example. 

Drive Status, Memory Status, Power Supply Status. 

```
0 = OK
1 = Warning
2 = Critical
3 = Unknown
```

### Alerting Sensors

These alert rules can be found inside the Alert Rules Collection. The alert rules below are
the default alert rules, there are more device-specific alert rules in the alerts collection. 

**Sensor Over Limit Alert Rule:**  Will alert on any sensor value that is over the limit.

**Sensor Under Limit Alert Rule:** Will alert on any sensor value that is under the limit.

**Remember** you can set these limits inside device settings in the Web UI.

**State Sensor Critical:** Will alert on any state that returns critical = 2

**State Sensor Warning:** Will alert on any state that returns warning = 1

**Wireless Sensor Over Limit Alert Rule:** Will Alert on sensors that listed in device settings under Wireless.

**Wireless Sensor Under Limit Alert Rule:** Will Alert on sensors that listed in device settings under Wireless.