Domotz allows you to monitor TCP Services and SNMP (v1, v2, v3) objects available on your connected devices.
Monitoring SNMP objects
Domotz allows you to monitor SNMP OIDs by periodically polling the device and displaying the extracted value. Here is a summary:
- Domotz provides features to facilitate MIB navigation and identify the right OIDs.
- Numerical values are also put into charts.
- You can configure alerts, based on conditions of the extracted values.
- You can change the polling frequency.
- SNMP versions v1, v2 and v3 are supported.
Enabling SNMP Monitoring on a device
The first step is to make sure that SNMP is enabled on the device you want to monitor.
The next step is to tell Domotz the related credentials. This can be done from the Device Access Manager, in the upper part of the Device Details screen:
A dialog box for inserting the credentials will be prompted:
SNMP status
SNMP status is shown in the Device details view. At each point in the process, you can edit the authentication configuration or force a new retry.
Status “Checking”
The status will show as checking, for a newly discovered device. The same status will be displayed when selecting “Retry now”.
Status “Reading”
The status “Reading” is displayed when Domotz is allowed to read SNMP data from the device, using either the default communities (in case of SNMP v1, v2) or the user-defined authentication configuration (for SNMP v1, v2, v3).
SNMP Status “Service not found”
The status, “Service not found” is displayed if the Agent detects that the required UDP port 161 is closed:
Status “Unable to read from SNMP service”
This status is displayed when the UDP port 161 is opened but the agent is not capable of retrieving data using the current authentication configuration.
Configuring SNMP sensors
In the Device Details screen go to the SNMP tab and click on Add an SNMP Sensor.
The following dialog will appear. If Domotz already knows the MIB corresponding to the device a navigation panel will allow you to select the right OID to monitor.
If Domotz does not have any MIB associated, you can still configure OIDs manually by clicking on Manually define an SNMP Sensor. Enter the OID you want to monitor and assign a name, description and type to it.
Domotz will confirm that the OID is in the correct format but it is unable to verify the value entered is valid.
The type of value the OID will return must match the manufacturer documentation and is important for the types of Alerts you want to create.
Monitoring SNMP sensors
Once you have configured your sensors you will see them listed in the SNMP section. This will include the value the device is returning for that OID and the last time the information was updated.
Domotz also keeps the history of numerical OIDS. By clicking on the chart icon you will see a chart like the following:
Alerts on SNMP sensors
You can configure alerts on the SNMP sensors you have created from the Alerts section of the device:
Domotz will ask you to choose one of the sensors you have already created (and it will also prompt you to create a new one if desired):
After choosing a sensor, you will be able to configure the alert. Assign a Name, Condition, and the Communication Channel for the alert:
And, finally, the alert is configured:
Other uses of SNMP within Domotz
SNMP is a powerful protocol. It is also used by Domotz to implement Network mapping algorithms, PoE management as well as Network Interface Monitoring. Please refer to the respective sections for more details.
It’s important to note that these features are only available if Domotz knows the SNMP credential of a device.
Please make sure that these are configured through the Access Manager of devices:
