Domotz Pro User Guide

4.4.5. Eyes

Domotz Eyes allow you to monitor services and other details on your network devices. Currently this includes:

 

  • TCP Services

 

  • SNMPv2 Sensors (via OID)

 

Other monitoring services may be added in the future.

4.4.5.1. Configuring a Domotz Eye

You will now see a new tab labelled Eyes. This is where you will configure the various TCP services or SNMP sensors. Please note that you can configure a maximum of 20 TCP services per device and unlimited SNMP sensors.


Initial Domotz Eyes Configuration screen:

4.4.5.2. How to add a TCP Service to be monitored

To Add a new TCP service to monitor, enter the name of the service or TCP port number associated with it and the search box will return all available services that match the text entered:

Once the TCP service is added, the Domotz Agent will start monitoring that service. The port will be marked as available (green) if the Service is available on that port or unavailable (red) if not:

On every single TCP service monitored, the user can set a “Custom” alert (from the Alerts tab) to be informed when the service change status (from available to unavailable and vice-versa):

4.4.5.3. How to configure an SNMP Sensor

4.4.5.3.1. Determine OID

It is very helpful to use an MIB Browser iReader like the following:http://ireasoning.com/mibbrowser.shtml – free version for end users). Using this tool it is possible to navigate the OID tree for devices that support SNMP to find the OID sensor that you want to monitor.

 

It is important to configure your MIB tool for SNMP version 2c

The following is an example of a Sensor that will allow you to monitor the level of black ink level of my printer. In order to do this you will need to find some information in order to find the data you are looking for:

 

Index number for Black cartridge
Maximum level for the black ink cartridge (to compare to current level in order to determine percentage consumed).
Current level of black ink cartridge
 

In order to do this, you will do the following:


1. You identify the reference index for the black cartridge (in this case the index is 4):

Using this index, I can get other details for OIDs that are related to this cartridge, i.e. the Maximum level and actual level of the toner in that cartridge which I can then monitor and use to define my alerts.

 

2. From the OID of the SuppliesMaxCapacity (in my case 1.3.6.1.2.1.43.11.1.1.8.1.4): you get 2500. This is the MAX value of the black toner that is supported by my printer. I will need this later to set up the alert.

 


3. Then you can get the the OID of the SuppliesLevel (the OID for the Black cartridge in the example is 1.3.6.1.2.1.43.11.1.1.9.1.4)

This OID is what you will add to Domotz and will begin to monitor from the Eye tab of the device (1.3.6.1.2.1.43.11.1.1.9.1.4)

You can refer to the manufacturer’s documentation to determine the correct OID and expected values

4.4.5.3.2. Configure SNMP Sensor in Domotz

(using OID suggestions)

 

In the Device Details screen go to the Eye tab and click on 'Add an SNMP Sensor':

If Domotz has the selected device's OID information present in its database, you'll find a list of suggested OID when adding a new SNMP sensor as below. You can click on the '+' icon next to a specific OID to add that SNMP sensore to the device.

 

This feature requires SNMP enabled on the device, with the community strings correctly configured in the SNMP section of the Device Detail @4.4.1.9. SNMP V2 Community strings‍ 

(throught discovered OID)

In the Device Details screen go to the Eye tab and click on 'Add an SNMP Sensor'. If the Suggested OID list is empty or you simply want to add a custom OID you can click on 'Insert OID' and you'll be prompted with the following popup:

From this screen, you will need to add:

 

  • Sensor Name

 

  • Assign to category (for sorting purposes):
  • Insert OID

 

  • Define output type of Sensor (String or Numeric)

 

Domotz will confirm that the OID is in the correct format but cannot check that 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 then wish to create based on this Sensor (see Setting @4.4.3. Alerts‍).


Once you have configured your Sensors you will see them listed with the value that the device is returning for that OID. By clicking on the arrows on the far right you can show/hide details of the individual Sensors.

SNMP Sensors Name, Category and Type fields may be edited (clicking on pencil icon), but the OID cannot be changed.


If SNMP data of the selected device are present in the system, the user is prompted with a window suggesting available OIDs configurable for that specific device.


The user can accept the suggestion or edit it, modifying the proposed values.


If any of the suggestions suits the user needs, he can proceed inserting his own sensors, through the procedure described above.

 
powered by tomehost