Integrating Didactum into PRTG – Step-by-Step
Prerequisites
Didactum monitoring devices are specialized rack monitoring units that provide environmental parameters such as temperature, humidity, voltage, leakage, and door contacts via SNMP. This guide describes the complete integration into Paessler PRTG Network Monitor.
Required:
- PRTG Network Monitor (version 22.x or newer) with administrator access
- Didactum monitoring device (e.g. rack monitoring) reachable on the network
- SNMP enabled on the Didactum device (default: SNMP v2c)
- Network communication: UDP port 161 (SNMP) enabled from the PRTG probe to the Didactum device
- SNMP community string known (default: public)
- MIB file of the Didactum device (available from the manufacturer or retrievable from the device)
1. Enable SNMP via the Web Interface
- Access web interface: Open a browser and enter the IP address of the Didactum device (e.g. 192.168.1.100). Default login: admin / admin.
- Open network/SNMP settings: Navigation: Settings → Network → SNMP (or: Settings → Network → SNMP)
- Enable and configure SNMP:
- SNMP enabled: Yes / Enable
- SNMP version: v2c (recommended) or v3 for enhanced security
- Community string (v2c): public (or custom string, e.g. didactum_monitor)
- SNMP port: 161 (default, UDP)
- Allowed Managers: enter the IP address of the PRTG server (security)
- Configure trap receiver (optional): SNMP trap receiver: IP of the PRTG server, port 162 (UDP). This enables proactive alarm notifications from the device to PRTG.
- Save settings and restart the device if necessary. On some models, a restart is required for SNMP to become active.
Note: SNMP v3 provides authentication and encryption. Recommended for production environments. Protocol: SHA, encryption: AES128.
Warning: Be sure to change the default community string public in production environments to prevent unauthorized SNMP access.
2. Test SNMP Connectivity
Before configuring PRTG, test SNMP connectivity from the PRTG probe server:
# On Linux / from a Linux system:
snmpwalk -v2c -c public 192.168.1.100 # Query a specific OID (system description):
snmpget -v2c -c public 192.168.1.100 1.3.6.1.2.1.1.1.0 Windows: Use the built-in PRTG SNMP tester:
On the Paessler website:
Setup → Downloads → PRTG Tools → SNMP Tester
3. Import the MIB file into PRTG
By importing the Didactum MIB file, PRTG can automatically translate OID numbers into readable names and enables the convenient SNMP MIB Import sensor.
3.1 Obtain MIB file
- Direct download from the device: <DEVICE-IP>/mib/ (if available)
- Typical file name: DIDACTUM.mib
3.2 Import MIB file into PRTG
- Copy the MIB file to the PRTG Core server:
- Windows: C:\\Program Files (x86)\\PRTG Network Monitor\\snmpmibs\\
- Linux probe: /usr/local/prtg/snmpmibs/
- Open the PRTG web interface: Log in as administrator.
- Upload the MIB file (from PRTG 22.x): Navigation: Setup → System Administration → SNMP MIBs → Upload MIB file. Button “Upload MIB File" → select .mib file → confirm.
- Restart PRTG services: Setup → System Administration → Restart Core Server so that the MIB is loaded.
- Verify MIB import: When creating an “SNMP Custom Table" sensor, check whether the Didactum OIDs are displayed with readable names.
3.3 MIB configuration reference (main OID ranges)
-- DIDACTUM-RACKMONI2-MIB configuration reference
-- OID root: 1.3.6.1.4.1.3854 (Didactum enterprise OID)
-- System information:
sysDescr 1.3.6.1.2.1.1.1.0 -- Device description
sysName 1.3.6.1.2.1.1.5.0 -- Device name
sysUpTime 1.3.6.1.2.1.1.3.0 -- Uptime (hundredths of seconds)
-- Temperature sensors (sensor 1–8, {n} = sensor index):
tempValue 1.3.6.1.4.1.3854.1.2.2.1.16.1.3.{n} -- Value × 10
tempStatus 1.3.6.1.4.1.3854.1.2.2.1.16.1.4.{n} -- 0=OK, 1=Warn, 2=Alarm
tempHighAlarm 1.3.6.1.4.1.3854.1.2.2.1.16.1.7.{n} -- Upper threshold
tempLowAlarm 1.3.6.1.4.1.3854.1.2.2.1.16.1.8.{n} -- Lower threshold
-- Leakage sensors:
leakStatus 1.3.6.1.4.1.3854.1.2.2.1.18.1.4.{n} -- 0=OK, 1=Leakage
leakName 1.3.6.1.4.1.3854.1.2.2.1.18.1.2.{n} -- Sensor name
-- Humidity sensors:
humValue 1.3.6.1.4.1.3854.1.2.2.1.17.1.3.{n} -- Value in % RH
humStatus 1.3.6.1.4.1.3854.1.2.2.1.17.1.4.{n} -- 0=OK, 1=Warn, 2=Alarm
-- Voltage sensors:
voltValue 1.3.6.1.4.1.3854.1.2.2.1.15.1.3.{n} -- Value in V × 10
voltStatus 1.3.6.1.4.1.3854.1.2.2.1.15.1.4.{n} -- 0=OK, 1=Warn, 2=Alarm
4. OID Reference: Temperature and Leakage Sensors
All OIDs listed below are based on the Didactum enterprise OID base 1.3.6.1.4.1.3854. The placeholder {n} represents the sensor index (1 = first sensor, 2 = second sensor, etc.).
Important:
Didactum returns temperature values with a factor of 10 (e.g. 235 = 23.5°C). In PRTG, enter the value 0.1 under “Factor" in the channel configuration!
4.1 Temperature sensors
| OID | Description | Unit | Data type | Example value |
|---|---|---|---|---|
| 1.3.6.1.4.1.3854.1.2.2.1.16.1.3.1 | Temperature sensor 1 (value × 10) | °C × 10 | Integer | 235 |
| 1.3.6.1.4.1.3854.1.2.2.1.16.1.3.2 | Temperature sensor 2 (value × 10) | °C × 10 | Integer | 198 |
| 1.3.6.1.4.1.3854.1.2.2.1.16.1.3.3 | Temperature sensor 3 (value × 10) | °C × 10 | Integer | 210 |
| 1.3.6.1.4.1.3854.1.2.2.1.16.1.4.1 | Temperature status sensor 1 | Enum | Integer | 0 (OK) |
| 1.3.6.1.4.1.3854.1.2.2.1.16.1.4.2 | Temperature status sensor 2 | Enum | Integer | 1 (Warning) |
| 1.3.6.1.4.1.3854.1.2.2.1.16.1.7.1 | Temperature upper threshold sensor 1 | °C × 10 | Integer | 350 |
| 1.3.6.1.4.1.3854.1.2.2.1.16.1.8.1 | Temperature lower threshold sensor 1 | °C × 10 | Integer | 50 |
| 1.3.6.1.4.1.3854.1.2.2.1.16.1.2.1 | Temperature sensor 1 name | Text | String | Temp_Front |
4.2 Leakage sensors
| OID | Description | Unit | Data type | Example value |
|---|---|---|---|---|
| 1.3.6.1.4.1.3854.1.2.2.1.18.1.4.1 | Leakage status sensor 1 | Enum | Integer | 0 (OK) |
| 1.3.6.1.4.1.3854.1.2.2.1.18.1.4.2 | Leakage status sensor 2 | Enum | Integer | 0 (OK) |
| 1.3.6.1.4.1.3854.1.2.2.1.18.1.3.1 | Leakage value sensor 1 (0 = dry) | Status | Integer | 0 |
| 1.3.6.1.4.1.3854.1.2.2.1.18.1.2.1 | Leakage sensor 1 name | Text | String | Leak_Floor |
| 1.3.6.1.4.1.3854.1.2.2.1.18.1.5.1 | Leakage alarm threshold sensor 1 | Enum | Integer | 1 |
4.3 Humidity sensors
| OID | Description | Unit | Data type | Example value |
|---|---|---|---|---|
| 1.3.6.1.4.1.3854.1.2.2.1.17.1.3.1 | Humidity sensor 1 | % RH | Integer | 45 |
| 1.3.6.1.4.1.3854.1.2.2.1.17.1.3.2 | Humidity sensor 2 | % RH | Integer | 52 |
| 1.3.6.1.4.1.3854.1.2.2.1.17.1.4.1 | Humidity status sensor 1 | Enum | Integer | 0 (OK) |
| 1.3.6.1.4.1.3854.1.2.2.1.17.1.7.1 | Upper threshold sensor 1 | % RH | Integer | 80 |
| 1.3.6.1.4.1.3854.1.2.2.1.17.1.8.1 | Lower threshold sensor 1 | % RH | Integer | 20 |
4.4 Additional sensor OIDs
| OID | Description | Unit | Data type | Example value |
|---|---|---|---|---|
| 1.3.6.1.4.1.3854.1.2.2.1.15.1.3.1 | Voltage sensor 1 (value × 10) | V × 10 | Integer | 2298 |
| 1.3.6.1.4.1.3854.1.2.2.1.15.1.4.1 | Voltage status sensor 1 | Enum | Integer | 0 (OK) |
| 1.3.6.1.4.1.3854.1.2.2.1.10.1.3.1 | Door contact status 1 | Enum | Integer | 0 (closed) |
| 1.3.6.1.4.1.3854.1.2.2.1.11.1.3.1 | Shock / motion sensor 1 | Enum | Integer | 0 (none) |
| 1.3.6.1.4.1.3854.1.2.2.1.14.1.3.1 | Smoke detector status 1 | Enum | Integer | 0 (OK) |
| 1.3.6.1.2.1.1.3.0 | System uptime (sysUpTime) | hundredths of seconds | TimeTicks | 123456789 |
4.5 Status code meaning (enum values)
| Value | Status | Description / PRTG interpretation |
|---|---|---|
| 0 | OK / Normal | Measured value within thresholds → PRTG: Up |
| 1 | Warning | Measured value in warning range → PRTG: Warning |
| 2 | Alarm / Critical | Threshold exceeded → PRTG: Down / Error |
| 3 | Sensor error | Sensor not reachable / defective → PRTG: Error |
5. Creating PRTG Sensors
5.1 Add Device in PRTG
- In PRTG, navigate to the desired group under which the Didactum device should appear.
- Click on Add Device. Enter hostname or IP address.
- Settings: SNMP version v2c, community string, port 161.
- Save the device. PRTG will now attempt to reach the device via SNMP.
5.2 SNMP Custom Value Sensor (single value)
A separate SNMP Custom Value sensor is created for each sensor value:
- On the Didactum device in PRTG: + → Add Sensor → SNMP Custom Value.
- Configuration:
- Sensor name: e.g. Temperature Rack Front
- OID: 1.3.6.1.4.1.3854.1.2.2.1.16.1.3.1
- SNMP Data Type: Integer
- Channel settings (important for temperature sensors!):
- Unit: Custom → Unit: °C
- Factor: 0.1 (value ÷ 10, since Didactum outputs × 10)
- Decimal Places: 1
- Limits:
- Warning limit (upper): 35 °C
- Error limit (upper): 40 °C
- Warning limit (lower): 5 °C
- Save the sensor. PRTG will begin data acquisition according to the configured scan interval.
5.3 SNMP Custom Table Sensor (all sensors at once)
With the SNMP Custom Table Sensor, all channels can be queried using a single table OID – particularly efficient for devices with many sensors.
- On the device: + → Add Sensor → SNMP Custom Table.
- Enter table OID:
- Temperatures: 1.3.6.1.4.1.3854.1.2.2.1.16.1
- Leakage: 1.3.6.1.4.1.3854.1.2.2.1.18.1
- Configure columns:
- Column .2 → Sensor name
- Column .3 → Measured value (Integer, factor 0.1)
- Column .4 → Status code (0/1/2)
- Automatically adopt sensor channel names from MIB column .2.
- Configure limits and notifications, then save the sensor.
Hint: The SNMP Custom Table Sensor significantly reduces the number of required sensors and puts less load on the device.
6. Configure SNMP Trap Sensor
SNMP traps allow the Didactum device to immediately send a notification to PRTG in the event of alarms – without PRTG having to actively poll. Ideal for time-critical events such as leakage alarms.
6.1 Enable SNMP Trap Receiver in PRTG
- In PRTG: Setup → System Administration → Core & Probes → Probe Settings.
- Enable option SNMP Trap Receiver. UDP port 162 must be opened in the firewall.
- Create sensor: + → Add Sensor → SNMP Trap Receiver.
- Trap filter: OID 1.3.6.1.4.1.3854 (all Didactum traps), source IP: IP of the Didactum device.
- On the Didactum device: enter SNMP Trap Receiver = IP of the PRTG server, port 162.
6.2 Important Didactum Trap OIDs
| OID | Description | Type |
|---|---|---|
| 1.3.6.1.4.1.3854.1.7.1 | Temperature alarm trap | Sends OID + value |
| 1.3.6.1.4.1.3854.1.7.2 | Leakage alarm trap | Status 0 or 1 |
| 1.3.6.1.4.1.3854.1.7.3 | Humidity alarm trap | Sends OID + value |
| 1.3.6.1.4.1.3854.1.7.4 | Voltage alarm trap | Sends OID + value |
| 1.3.6.1.4.1.3854.1.7.10 | Door contact alarm trap | 0 = closed, 1 = open |
| 1.3.6.1.4.1.3854.1.7.99 | Device reboot trap | System reboot |
7. Notifications and Alarms
- PRTG: Setup → Notifications → Create new notification.
- Trigger: Sensor in Down or Error state → Immediately (0 minutes delay).
- Method: Email to administrator distribution list AND SMS to on-call number.
- Subject template: [ALARM] Leakage detected: %sensorname on %device (%datetime)
- Sensor filter: Only notify sensors with tag leakage or didactum-leak.
- Assign notification to the leakage sensor: Sensor → Settings → Notifications.
7.2 Recommended thresholds for rack monitoring
| Sensor type | Warning (low) | Warning (high) | Alarm (high) | Standard / Recommendation |
|---|---|---|---|---|
| Temperature (IT rack) | 5 °C | 30 °C | 35 °C | ASHRAE A1: 15–32 °C |
| Temperature (UPS room) | 10 °C | 25 °C | 30 °C | Follow manufacturer specifications |
| Humidity | 20 % RH | 70 % RH | 80 % RH | ASHRAE: 20–80 % RH |
| Leakage | – | – | Immediate (value ≥ 1) | 0 minutes delay |
| Voltage (230 V AC) | 207 V (−10 %) | 253 V (+10 %) | 260 V | EN 50160 |
8. Troubleshooting
| Problem | Possible cause / solution |
|---|---|
| SNMP Timeout / No Response | Firewall: is UDP port 161 open? Is the IP address correct? Is SNMP enabled on the device? Does the community string match? Are Allowed Managers configured too restrictively? |
| Incorrect temperature value (e.g. 235 instead of 23.5) | Set the factor in the channel to 0.1. Didactum outputs values × 10. |
| OID returns "noSuchObject" | Sensor not connected or wrong index. Perform an SNMP walk to determine existing OIDs. |
| MIB import fails | Check MIB syntax (for example with a MIB browser). Dependent MIBs (RFC1213-MIB, SNMPv2-SMI) must also be present. |
| Traps are not received | Allow UDP 162 in the Windows firewall of the PRTG server. Is the trap receiver enabled in PRTG? Is the correct IP configured on the Didactum device? |
| Sensor shows "Down" despite OK value | Check threshold settings. For status OIDs: configure the limit type "not equal 0" for alarm. |
Diagnostic commands
# SNMP Walk – list all available OIDs of the Didactum device:
snmpwalk -v2c -c public 192.168.1.100 1.3.6.1.4.1.3854 # Query single OID (sensor 1 temperature):
snmpget -v2c -c public 192.168.1.100 1.3.6.1.4.1.3854.1.2.2.1.16.1.3.1 # SNMP v3 query:
snmpget -v3 -l authPriv -u snmpuser -a SHA -A passwort123 \\ -x AES -X encryptpw 192.168.1.100 1.3.6.1.4.1.3854.1.2.2.1.16.1.3.1
Appendix: OID quick reference
| # | OID | Sensor type | PRTG sensor type |
|---|---|---|---|
| 1 | 1.3.6.1.4.1.3854.1.2.2.1.16.1.3.{n} | Temperature value (× 10) | SNMP Custom Value, Factor 0.1 |
| 2 | 1.3.6.1.4.1.3854.1.2.2.1.16.1.4.{n} | Temperature status | SNMP Custom Value, Limits 0–0 |
| 3 | 1.3.6.1.4.1.3854.1.2.2.1.17.1.3.{n} | Humidity (%) | SNMP Custom Value |
| 4 | 1.3.6.1.4.1.3854.1.2.2.1.17.1.4.{n} | Humidity status | SNMP Custom Value, Limits 0–0 |
| 5 | 1.3.6.1.4.1.3854.1.2.2.1.18.1.4.{n} | Leakage status | SNMP Custom Value, Error if ≥ 1 |
| 6 | 1.3.6.1.4.1.3854.1.2.2.1.15.1.3.{n} | Voltage (V × 10) | SNMP Custom Value, Factor 0.1 |
| 7 | 1.3.6.1.4.1.3854.1.2.2.1.10.1.3.{n} | Door contact status | SNMP Custom Value |
| 8 | 1.3.6.1.4.1.3854.1.2.2.1.14.1.3.{n} | Smoke detector status | SNMP Custom Value, Error if ≥ 1 |
| 9 | 1.3.6.1.4.1.3854.1.7.* | SNMP Traps (all) | SNMP Trap Receiver |
| 10 | 1.3.6.1.2.1.1.3.0 | System Uptime | SNMP Custom Value |