SNMP and TCP services

Domotz allows you to monitor TCP Services and SNMP (v1, v2, v3) objects available on your connected devices.

In this article we describe:


If you are not familiar with the SNMP protocol, here is a blog post describing its main characteristics.
Here you can also find a useful example of monitoring Server Room Temperature using SNMP Sensors.

Monitoring TCP Services

In order to monitor TCP services exposed by a device, go to the SNMP/TCP tab within the Device screen.

SNMP and TCP screenshot 1

You can add a service to be monitored by clicking on Add a TCP Service and entering the name of the service or TCP port number associated.

SNMP and TCP screenshot 2

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:

SNMP and TCP screenshot 3

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):

SNMP and TCP services Monitoring screenshot 4

Monitoring SNMP objects

Domotz allows you to monitor SNMP OIDs explicitely, by polling periodically the device and displaying the extracted value. In particular:

  • Domotz provides featuers to facilitate the MIB navigation and identify the right OIDs.
  • Numerical values are also put in charts.
  • You can configure alerts, based on conditions on the extracted values.
  • It is possible to change the polling frequency.
  • SNMP versions v1, v2 and v3 are supported.

Enabling SNMP Monitoring on a device

First of all, make sure that SNMP is enabled on the device you want to monitor.

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.

SNMP and TCP screenshot 5

Domotz will prompt a dialog for inserting the protocol credentials:

SNMP and TCP screenshot 6

Configuring SNMP sensors

In the Device Details screen go to the SNMP/TCP 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.

SNMP and TCP screenshot 7

If Domotz does not have any associated MIB, you can still configure OIDs manually by clicking on Manually define an SNMP Sensor, by entering the OID you want to monitor and assigning a name, description and a type to it.

SNMP and TCP screenshot 8

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 wish to create.

In case Domotz does not show you the MIB of a device and you have got the MIB of that type of devices, we encourage you to contact and provide the MIB. Domotz will be able to insert that in the system, to improve and facilitate the User Experience.

In case Domotz does not show you the MIB of a device and you do not know the OID to us, we suggest trying with a MIB Browser. Here an article with some suggestions.

Monitoring SNMP sensors

Once you have configured your sensors you will see them listed in the SNMP/TCP section with the value that the device is returning for that OID, and the last time the information has been updated.

SNMP and TCP screenshot 9

Domotz also keeps the history of numerical OIDS. By clicking on the chart icon you will see a chart like the following:

SNMP and TCP screenshot 10

Alerts on SNMP sensors

You can configure alerts on the SNMP sensors you have created from the Alerts section of the device:

SNMP and TCP screenshot 11

Domotz will ask you to choose one among the sensors you have already created (it will also prompt here in case wont to to create a new one):

SNMP and TCP screenshot 12

After chosen a sensor, you will be finally able to configure the alert, by assigning a Name, a Condition, and the Communication Channel for the alert:

SNMP and TCP screenshot 13

And, finally, the alert is configured:

SNMP and TCP screenshot 14

Domotz SNMP and TCP usage and sampling configuration

All SNMP sensors and TCP services configured within Domotz are listed in a specific section, accessible from the right side of menu of the Device List of an agent:

SNMP and TCP screenshot 15

This page will give an overview of all the SNMP/TCP configured and will allow you to change the sampling frequency of the Domotz SNMP and TCP monitoring (increasing the frequency will decrease the number of SNMP/TCP you can monitor):

SNMP and TCP screenshot 16

Other usages 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.

Important to remark that these features are only available if Domotz knows the SNMP credential of devices.

Please make sure that these are configured through the Access Manager of devices:

SNMP and TCP screenshot 17

Updated on March 15, 2021

Was this article helpful?