Language selection:
Skip to main navigation Skip to main content Skip to page footer

Didactum monitoring and Zabbix 6 integration

Complete step-by-step guide for integrating Didactum monitoring devices and sensors into Zabbix 6.x LTS via SNMP – including template import, item configuration, triggers, and OID reference.

  • Zabbix version: 6.x LTS
  • Protocol: SNMP v1/v2c/v3
  • Devices: Didactum Monitoring System 100 / 300T / 500T / 550T
  • Sensors: Temperature, leakage, humidity, door contact, smoke

1. Prerequisites and System Overview

Zabbix server

  • Zabbix 6.x LTS installed and accessible
  • Packages snmp and snmp-mibs-downloader installed
  • UDP port 161 (SNMP polling) and UDP port 162 (SNMP traps) opened in the firewall
  • Zabbix process SNMPTrapper enabled (for trap reception)

Didactum device

  • Monitoring System 100T / 300T / 500T or 550T
  • Network access to the Zabbix server
  • SNMP enabled (v1/v2c or v3)
  • MIB file available in the web interface

Architecture

[Didactum Monitoring System]
  IP: 192.168.1.50
       |
       | SNMP Polling (UDP 161)    --Zabbix queries-->
       | SNMP Traps  (UDP 162)     <--Didactum sends--
       v
[Zabbix Server]
  IP: 192.168.1.10
  Web frontend: 192.168.1.10/zabbix

2. Enable SNMP on the Didactum device

Step 1 – Open web interface

Open in browser: 192.168.1.50 (adjust Didactum device IP)

Step 2 – Open SNMP settings

System Settings → SNMP

Step 3 – Enter the following values

Field in the Didactum web interfaceValue
Enable SNMPEnabled
SNMP versionv2c (recommended) or v3 for production environments
Community string (v1/v2c)didactum_mon (do not use “public"!)
SNMP port161
Trap receiver IP192.168.1.10 (IP of the Zabbix server)
Trap port162
Trap versionv2c

SNMPv3 settings (optional, increased security)

FieldValue / Example
Security namezabbix_user
Auth protocolSHA
Auth passwordat least 8 characters
Priv protocolAES
Priv passwordat least 8 characters
Security levelauthPriv

Step 4 – Save settings

Click the save icon. Then test SNMP from the Zabbix server:

snmpwalk -v 2c -c didactum_mon 192.168.1.50 .1.3.6.1.4.1.46501

If lines with OID values appear, SNMP is configured correctly.

3. Download the MIB file and install it on the Zabbix server.

Step 1 – Download MIB from the Didactum web interface

System Settings → SNMP → "Download MIB file" → didactum.mib

Step 2 – Install MIB on the Zabbix server

# Install SNMP tools (if not already installed)
sudo apt install snmp snmp-mibs-downloader -y

# Copy MIB file
sudo cp didactum.mib /usr/share/snmp/mibs/

# Adjust SNMP configuration
echo "mibdirs /usr/share/snmp/mibs" >> /etc/snmp/snmp.conf
echo "mibs ALL" >> /etc/snmp/snmp.conf

# Test with MIB name
snmpwalk -v 2c -c didactum_mon -m ALL 192.168.1.50 DIDACTUM-MIB::sensorValue

4. Create Didactum Host in Zabbix

Step 1 – Navigation

Configuration → Hosts → Create Host

Step 2 – Fill in the “Host” tab

FieldValue
Host nameDidactum-Monitor-01
Visible nameDidactum Monitoring System 01
GroupsDidactum master modules (create new or select existing)
Interfaces → AddSelect type: SNMP
IP address192.168.1.50
Port161

Step 3 – Fill in the “Macros” tab

Store the SNMP community string here as a macro:

MacroValue
{$SNMP_COMMUNITY}didactum_mon

For SNMPv3 additionally:

MacroValue
{$SNMPV3_USER}zabbix_user
{$SNMPV3_AUTHPASSPHRASE}Your auth password
{$SNMPV3_PRIVPASSPHRASE}Your priv password

Step 4 – Save host

Click Add.

The host now appears in the host list. The icon next to “SNMP” turns green once the connection works (may take a few minutes).

5. Import and Assign the Didactum Zabbix Template

Step 1 – Download official Didactum template

Didactum provides a free template. Download sources:

Step 2 – Import template into Zabbix

Configuration → Templates → Import (top right)

Select the file zbx_didactum_template.xml, leave all options enabled, click Import.

Step 3 – Assign template to the host

Configuration → Hosts → Didactum-Monitor-01 → Tab "Templates"
→ "Link new templates" → search for "Didactum" → select template → Add → Update

Step 4 – Check data

Monitoring → Latest data → Host: Didactum-Monitor-01

After a few minutes, the first measured values of all connected sensors will appear.

6. Manually Create SNMP Items (Without a Template)

If the Didactum template is not used or additional sensors are to be integrated, items can be created manually.

Navigation

Configuration → Hosts → Didactum-Monitor-01 → Items → Create Item

Item: Temperature value

FieldValue
NameTemperature Sensor 01
TypeSNMP agent
Keydidactum.temp[101001]
SNMP OID.1.3.6.1.4.1.46501.5.1.1.7.101001
SNMP community{$SNMP_COMMUNITY}
Type of informationNumeric (float)
Units°C
Multiplier0.1 (raw value ÷ 10 = degrees Celsius)
Update interval60s
History storage period90d
Trend storage period365d
ApplicationsDidactum Sensors

Item: Temperature sensor status

FieldValue
NameTemperature Sensor 01 – Status
TypeSNMP agent
SNMP OID.1.3.6.1.4.1.46501.5.1.1.6.101001
Type of informationNumeric (unsigned)
Unitsleave empty

Item: Water sensor / leakage

FieldValue
NameLeakage Sensor 01
TypeSNMP agent
SNMP OID.1.3.6.1.4.1.46501.5.1.1.7.107001
Type of informationNumeric (unsigned)
Value mappingDidactum Leak Status (see below)
Update interval30s

Create value mapping (for leakage and status sensors)

Administration → General → Value mapping → Create value map

Name: Didactum Sensor Status
  0  →  OK / Dry
  1  →  ALARM / Water detected
  2  →  No connection

Name: Didactum Leak Status
  0  →  Dry
  1  →  Water detected

7. Configure Triggers

Define triggers to specify when Zabbix generates an alert.

Navigation:

Configuration → Hosts → Didactum-Monitor-01 → Triggers → Create Trigger

Trigger: Temperature too high

FieldValue
NameTemperature too high: {HOST.NAME}
SeverityHigh
Expressionlast(/Didactum-Monitor-01/didactum.temp[101001])>28
Recovery expressionlast(/Didactum-Monitor-01/didactum.temp[101001])<26
DescriptionTemperature exceeds 28°C – check cooling system!

Trigger: Temperature critical

FieldValue
NameTemperature CRITICAL: {HOST.NAME}
SeverityDisaster
Expressionlast(/Didactum-Monitor-01/didactum.temp[101001])>35
DescriptionCritical temperature – immediate action required!

Trigger: Leakage detected

FieldValue
NameLEAKAGE detected: {HOST.NAME}
SeverityDisaster
Expressionlast(/Didactum-Monitor-01/didactum.leak[107001])=1
Recovery expressionlast(/Didactum-Monitor-01/didactum.leak[107001])=0
DescriptionWater leakage detected – immediate action required!

Trigger: Sensor not reachable

FieldValue
NameSensor connection error: {HOST.NAME}
SeverityAverage
Expressionlast(/Didactum-Monitor-01/didactum.temp.status[101001])=2

Note on thresholds:

  • The values 28°C and 35°C are examples.
  • Adjust them to the actual requirements of your infrastructure (e.g. server room: warning from 25°C, critical from 30°C).

8. SNMP OID Reference

All Didactum OIDs start with .1.3.6.1.4.1.46501 (older firmware) or .1.3.6.1.4.1.39052 (newer models). The sensor ID is appended at the end.

OID fields per sensor

FieldMeaningExample
.1.x.SENSOR_IDSensor ID.1.3.6.1.4.1.46501.5.1.1.1.101001
.5.x.SENSOR_IDSensor name.1.3.6.1.4.1.46501.5.1.1.5.101001
.6.x.SENSOR_IDStatus (0=OK, 1=Alarm, 2=No signal).1.3.6.1.4.1.46501.5.1.1.6.101001
.7.x.SENSOR_IDMeasured value (current value).1.3.6.1.4.1.46501.5.1.1.7.101001

Sensor types and corresponding OIDs

Sensor typeSensor IDOID measured valueOID statusUnit / Note
Temperature sensor (digital)101001.1.3.6.1.4.1.46501.5.1.1.7.101001.1.3.6.1.4.1.46501.5.1.1.6.101001Raw value ÷ 10 = °C (e.g. 235 = 23.5 °C)
Temperature sensor (analog)201001.1.3.6.1.4.1.39052.5.2.1.7.201001.1.3.6.1.4.1.39052.5.2.1.6.201001Raw value ÷ 10 = °C
Water sensor / leakage107001.1.3.6.1.4.1.46501.5.1.1.7.107001.1.3.6.1.4.1.46501.5.1.1.6.1070010 = dry, 1 = water detected
Humidity102001.1.3.6.1.4.1.46501.5.1.1.7.102001.1.3.6.1.4.1.46501.5.1.1.6.102001Value in % (e.g. 65 = 65 %)
Potential-free contact101003.1.3.6.1.4.1.39052.5.1.1.7.101003.1.3.6.1.4.1.39052.5.1.1.6.1010030 = open, 1 = closed
Door contact104001.1.3.6.1.4.1.46501.5.1.1.7.104001.1.3.6.1.4.1.46501.5.1.1.6.1040010 = closed, 1 = open
Smoke detector106001.1.3.6.1.4.1.46501.5.1.1.7.106001.1.3.6.1.4.1.46501.5.1.1.6.1060010 = no smoke, 1 = alarm

Determine sensor ID:

In the Didactum web interface under System tree → select sensor → Details. The displayed ID is appended to the end of the OID.

MIB prefix per model:

Older devices use .1.3.6.1.4.1.46501, newer ones may use .1.3.6.1.4.1.39052. Refer to the MIB file of your device for the exact OIDs.

9. Receiving SNMP Traps

In addition to active polling, Zabbix can also receive SNMP traps that the Didactum device sends automatically in case of an alarm.

Step 1 – Install snmptrapd

sudo apt install snmptrapd snmptt -y

Step 2 – Configure snmptrapd

sudo nano /etc/snmp/snmptrapd.conf

Enter the following content:

authCommunity execute,log,net didactum_mon
traphandle default /usr/sbin/snmptthandler

Step 3 – Configure Zabbix server for trap reception

sudo nano /etc/zabbix/zabbix_server.conf

Find and enable the following lines:

SNMPTrapperFile=/tmp/zabbix_traps.tmp
StartSNMPTrapper=1

Step 4 – Restart services

sudo systemctl restart snmptrapd
sudo systemctl restart zabbix-server

Step 5 – Create trap item in Zabbix

Configuration → Hosts → Didactum-Monitor-01 → Items → Create Item
FieldValue
NameSNMP Trap – Didactum Alarm
TypeSNMP trap
Keysnmptrap.fallback
Type of informationLog
Log time formathh:mm:ss yyyy/MM/dd

10. Set Up Email Notifications

Step 1 – Configure media type

Administration → Media types → Email → edit
FieldValue
SMTP serverYour mail server, e.g. mail.yourdomain.com
SMTP server port587 (TLS) or 465 (SSL)
SMTP heloyourdomain.com
SMTP email[zabbix@yourdomain.com](mailto:zabbix@yourdomain.com)
Connection securitySTARTTLS

Step 2 – Add email address for admin

Administration → Users → Admin → Media → Add
  Type: Email
  Send to: [your@email-address.com](mailto:your@email-address.com)
  When active: 1-7,00:00-24:00
  Severity: enable all

Step 3 – Create action for trigger alerts

Configuration → Actions → Trigger actions → Create action
FieldValue
NameDidactum alarm notification
Conditions → AddTrigger value = Problem
Operations → AddOperation type: Send message
Send to usersAdmin (or custom user group)
Send only toEmail

Message template (Subject / Message)

Subject:
ALARM: {TRIGGER.NAME} on {HOST.NAME}

Message:
Time:       {EVENT.DATE} {EVENT.TIME}
Host:       {HOST.NAME} ({HOST.IP})
Trigger:    {TRIGGER.NAME}
Severity:   {TRIGGER.SEVERITY}
Status:     {TRIGGER.STATUS}
Item:       {ITEM.NAME} = {ITEM.VALUE}

11. Troubleshooting

Test SNMP connection

# Simple connection test
snmpget -v 2c -c didactum_mon 192.168.1.50 sysDescr.0

# Retrieve all sensor values
snmpwalk -v 2c -c didactum_mon 192.168.1.50 .1.3.6.1.4.1.46501.5.1.1

# Retrieve a single temperature value
snmpget -v 2c -c didactum_mon 192.168.1.50 .1.3.6.1.4.1.46501.5.1.1.7.101001

Check Zabbix Latest Data

Monitoring → Latest data → Filter: Host = Didactum-Monitor-01

If values appear and the timestamp updates, polling works correctly.

Error messages and solutions

ProblemCause & solution
Host icon remains red / greySNMP connection failed → check IP, port, community string; allow UDP 161 in firewall
“No SNMP response"SNMP not enabled on the Didactum device or wrong community string
Temperature value appears 10x too highMultiplier missing → edit item, set multiplier to 0.1
Item shows “Not supported"OID incorrect or sensor ID wrong → check sensor ID in the Didactum web interface
No SNMP trap receivedTrap receiver IP incorrect in the Didactum web interface → enter Zabbix server IP; allow port 162
No email on alarmCheck media type, user media and action; view Zabbix log: /var/log/zabbix/zabbix_server.log

View Zabbix logs

sudo tail -f /var/log/zabbix/zabbix_server.log
sudo tail -f /var/log/zabbix/zabbix_agentd.log

Check Zabbix processes

sudo systemctl status zabbix-server
sudo systemctl status zabbix-agent
sudo systemctl status snmptrapd

12. Final Checklist

Didactum device

  • SNMP enabled (v2c or v3)
  • Community string set (not “public")
  • Trap receiver IP set to Zabbix server
  • Trap port 162 configured
  • MIB file downloaded

Zabbix server

  • Packages snmp, snmp-mibs-downloader installed
  • MIB file stored in /usr/share/snmp/mibs/
  • snmpwalk test successful
  • Didactum host created (SNMP interface, correct IP)
  • Macro {$SNMP_COMMUNITY} set with community string
  • Didactum template imported and assigned to the host
  • Latest Data shows sensor values

Items & triggers

  • Temperature item: multiplier 0.1 set, unit °C
  • Leakage item: value mapping configured
  • Trigger for temperature warning created
  • Trigger for leakage created (severity: Disaster)
  • Trigger for sensor connection error created

Alerting

  • Email media type configured
  • Admin user assigned an email address
  • Trigger action “Didactum Alarm” created
  • Test alarm triggered and email received

SNMP traps (optional)

  • snmptrapd installed and configured
  • zabbix_server.conf: StartSNMPTrapper=1 set
  • Trap item (snmptrap.fallback) created
  • Test trap received and visible in Latest Data

This website uses cookies

This website uses cookies to improve user experience. By using our website you consent to all cookies in accordance with our Cookie Policy.

Essential cookies enable basic functions and are necessary for the website to function properly.
Statistics cookies collect information anonymously. This information helps us to understand how our visitors use our website.
Marketing cookies are used by third parties or publishers to display personalized advertisements. They do this by tracking visitors across websites.