Skip to main content

D Link Systems Inc SNMP Traps

D Link Systems Inc SNMP Traps

Plugin: go.d.plugin Module: snmp_traps

Maintained by Netdata

Overview​

Receive, decode, and store SNMP traps and INFORMs from D Link Systems Inc devices with Netdata. The bundled D Link Systems Inc trap profile decodes 1105 trap definitions across 180 MIBs into structured journal events with named, typed varbinds — searchable and filterable in the Logs tab.

Netdata's SNMP trap listener receives traps on UDP/162, matches them to the D Link Systems Inc enterprise OID space, and decodes the varbinds using the bundled D Link Systems Inc trap profile. No per-trap configuration.

This integration is supported on all platforms.

This integration supports multiple instances configured side-by-side.

Default Behavior​

Auto-Detection​

Traps from D Link Systems Inc devices are decoded automatically once the device is pointed at the Agent's trap listener.

Limits​

The default configuration for this integration does not impose any limits.

Performance Impact​

The default configuration for this integration is not expected to impose a significant performance impact on the system.

Setup​

You can configure the snmp_traps collector in two ways:

MethodBest forHow to
UIFast setup without editing filesGo to Nodes → Configure this node → Collectors → Jobs, search for snmp_traps, then click + to add a job.
FileIf you prefer configuring via file, or need to automate deployments (e.g., with Ansible)Edit go.d/snmp_traps.conf and add a job.
important

UI configuration requires paid Netdata Cloud plan.

Prerequisites​

Devices configured to send traps​

The devices must be configured to send SNMP traps or INFORMs to the Netdata Agent acting as the site's trap receiver, and the trap port must be reachable from them.

A usable Netdata log directory​

Jobs that write direct journals store them under ${NETDATA_LOG_DIR}/traps/ — /var/log/netdata on package installs, /opt/netdata/var/log/netdata on static ones. Job creation fails if that directory is missing or unwritable. A job that only exports over OTLP can set journal.enabled: false instead.

Permission to bind the trap port​

The default listener is UDP/162, a privileged port: binding it needs CAP_NET_BIND_SERVICE or root on Linux. Netdata packages grant this capability, so standard installations just work; hardened or custom deployments must grant it, or move the listener to an unprivileged port.

Configuration​

Options​

Configure the trap listener: the address and port it binds, the SNMP versions and credentials it accepts, and the enrichment options — see the SNMP Trap Listener page for the full option reference. Trap decoding itself needs no configuration: the stock trap profiles ship with Netdata.

via UI​

Configure the snmp_traps collector from the Netdata web interface:

  1. Go to Nodes.
  2. Select the node where you want the snmp_traps data-collection job to run and click the ⚙ (Configure this node). That node will run the data collection.
  3. The Collectors → Jobs view opens by default.
  4. In the Search box, type snmp_traps (or scroll the list) to locate the snmp_traps collector.
  5. Click the + next to the snmp_traps collector to add a new job.
  6. Fill in the job fields, then click Test to verify the configuration and Submit to save.
    • Test runs the job with the provided settings and shows whether data can be collected.
    • If it fails, an error message appears with details (for example, connection refused, timeout, or command execution errors), so you can adjust and retest.

via File​

The configuration file name for this integration is go.d/snmp_traps.conf.

The file format is YAML. Generally, the structure is:

update_every: 1
autodetection_retry: 0
jobs:
  - name: some_name1
  - name: some_name2

You can edit the configuration file using the edit-config script from the Netdata config directory.

cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
sudo ./edit-config go.d/snmp_traps.conf
Examples​
Basic (SNMPv1/v2c)​

A single listener on the standard trap port, accepting any SNMPv1/v2c community. listen is required: without an endpoint the job binds nothing. Restrict the allowlist for production.

jobs:
  - name: local
    listen:
      endpoints:
        - protocol: udp
          address: 0.0.0.0
          port: 162
    versions:
      - v1
      - v2c

Alerts​

There are no alerts configured by default for this integration.

Metrics​

Netdata decodes 1105 trap definitions from D Link Systems Inc across 180 MIBs into structured journal events. A trap is decoded only if the device actually sends it; inclusion here means the profile can decode it.

By severity: emerg 4 · alert 99 · crit 26 · err 52 · warning 452 · notice 436 · info 36

By category: state_change 462 · config_change 53 · security 259 · auth 38 · license 6 · mobility 7 · diagnostic 246 · unknown 34

Coverage by MIB​

180 MIBs decoded — show per-MIB trap counts
MIBTrap definitions
DLINK-3100-TRAPS-MIB73
DES-1210-28ME-B333
DES-1210-10MEbx31
DES-1210-26MEbx31
DLINK-DXS-1210-16TC-AX-MIB29
DES-1210-28MEbx23
DGS-1210-12TSME-BX23
DGS-1210-28XME-BX23
DGS-1210-28XSME-BX23
DNS110004-MIB20
DNS120005-MIB20
DES-1210-10AXME16
DES-1210-28-AXME16
EQUIPMENT-MIB16
DGS-1100-06ME-AX15
DWL-320015
DAP-3520-v11514
DLINK-MCB-MIB14
SINGLE-IP-MIB14
DES-1210-08P-AX13
DES-1210-28P-Ax13
DLINK-DXS-1210-10TS-AX-MIB13
DLINK-DXS-1210-12SC-AX-MIB13
DLINK-DXS-1210-12TC-AX-MIB13
DES3526-L2MGMT-MIB11
DES3550-L2MGMT-MIB11
AGENT-GENERAL-MIB9
DES1228MEv2-28-L2MGMT-MIB7
DLINK-3100-Physicaldescription-MIB7
DLMS-MIB7
DES-1210-28-AX6
DES-1210-28-BX6
DES-1210-52-BX6
DES-1210-52-CX6
DES-1526-MIB6
DES-2108-MIB6
DES-2110-MIB6
DES3200-10-L2MGMT-MIB6
DES3200-10DC-L2MGMT-MIB6
DES3200-18-L2MGMT-MIB6
DES3200-18DC-L2MGMT-MIB6
DES3200-26-L2MGMT-MIB6
DES3200-26DC-L2MGMT-MIB6
DES3200-28-L2MGMT-MIB6
DES3200-28F-L2MGMT-MIB6
DES3200-28ME-L2MGMT-MIB6
DES3200-28P-L2MGMT-MIB6
DES3200-52-L2MGMT-MIB6
DES3200-52DC-L2MGMT-MIB6
DES3200-52P-L2MGMT-MIB6
DES3200ME-28-L2MGMT-MIB6
DES3528-L2MGMT-MIB6
DES3528DC-L2MGMT-MIB6
DES3528P-L2MGMT-MIB6
DES3552-L2MGMT-MIB6
DES3552P-L2MGMT-MIB6
DES3828-L2MGMT-MIB6
DES3828DC-L2MGMT-MIB6
DES3828P-L2MGMT-MIB6
DES3852-L2MGMT-MIB6
DES3852P-L2MGMT-MIB6
DGS-1210-24-AX6
DGS-1210-48-AX6
DGS-1210-52-BX6
DGS3000-10TC-L2MGMT-MIB6
DGS3000-24TC-L2MGMT-MIB6
DGS3000-26TC-L2MGMT-MIB6
DGS3000-28SC-L2MGMT-MIB6
DGS3200-L2MGMT-MIB6
DGS3216-L2MGMT-MIB6
DGS3224-L2MGMT-MIB6
IP-MAC-BIND-MIB6
DES3028G-L2MGMT-MIB5
DES3028P-L2MGMT-MIB5
DES3052-L2MGMT-MIB5
DES3052P-L2MGMT-MIB5
DGS-3700-12-L2MGMT-MIB5
DGS-3700-12G-L2MGMT-MIB5
DGS-6600-STP-EXT-MIB5
DGS3426-L2MGMT-MIB5
DGS3426G-L2MGMT-MIB5
DGS3426P-L2MGMT-MIB5
DGS3427-L2MGMT-MIB5
DGS3450-L2MGMT-MIB5
DGS3612-L2MGMT-MIB5
DGS3612G-L2MGMT-MIB5
DGS3627-L2MGMT-MIB5
DGS3627G-L2MGMT-MIB5
DGS3650-L2MGMT-MIB5
DLINKSW-ENTITY-EXT-MIB5
DLINKSW-STACK-MIB5
DLINKSW-SYSTEM-FILE-MIB5
CFMEXTENSION-MIB4
DES3225G-MIB4
DLINK-3100-COPY-MIB4
DLINKSW-ERROR-DISABLE-MIB4
DLINKSW-LBD-MIB4
DLINKSW-POE-MIB4
DNS-340L-MIB4
DNS343-MIB4
DNS345-MIB4
LOOPBACK-DETECT-MIB4
DES-1210-26ME-B23
DES1228ME-L2MGMT-MIB3
DES7200-SYSTEM-MIB3
DGS-3420-26SC-L2MGMT-MIB3
DGS-3420-28PC-L2MGMT-MIB3
DGS-3420-28SC-L2MGMT-MIB3
DGS-3420-28TC-L2MGMT-MIB3
DGS-3420-52P-L2MGMT-MIB3
DGS-3420-52T-L2MGMT-MIB3
DGS-6600-VPLS-GENERIC-MIB3
DLINKSW-ERPS-MIB3
DLINKSW-MAC-AUTH-MIB3
ERPS-MIB3
Mac-Based-Authentication-MIB3
BPDU-PROTECTION-MIB2
DDM-MGMT-MIB2
DES-1226G-MIB2
DES2218-MIB2
DES3010F-L2MGMT-MIB2
DES3010FL-L2MGMT-MIB2
DES3010g-L2MGMT-MIB2
DES3016-L2MGMT-MIB2
DES3018-L2MGMT-MIB2
DES3026-L2MGMT-MIB2
DES3028-L2MGMT-MIB2
DES3810-28-L2MGMT-MIB2
DES3810-52-L2MGMT-MIB2
DES7200-ENTITY-MIB2
DES7200-SMP-MIB2
DGS-3120-48TC-L2MGMT-MIB2
DGS-3620-28PC-L2MGMT-MIB2
DGS-3620-28SC-DC-L2MGMT-MIB2
DGS-3620-28SC-L2MGMT-MIB2
DGS-3620-28TC-DC-L2MGMT-MIB2
DGS-3620-28TC-L2MGMT-MIB2
DGS-3620-52P-L2MGMT-MIB2
DGS-3620-52T-L2MGMT-MIB2
DGS3024-L2MGMT-MIB2
DGS3120-24PC-L2MGMT-MIB2
DGS3120-24SC-DC-L2MGMT-MIB2
DGS3120-24SC-L2MGMT-MIB2
DGS3120-24TC-L2MGMT-MIB2
DGS3120-48PC-L2MGMT-MIB2
DGS3312SR-L2MGMT-MIB2
DLINK-3100-LLDP-MIB2
DLINK-3100-rlBrgMulticast-MIB2
DLINKSW-BPDU-PROTECTION-MIB2
DLINKSW-DDM-MIB2
DLINKSW-DOS-PREVENT-MIB2
DLINKSW-DOT1X-EXT-MIB2
DLINKSW-SAFEGUARD-ENGINE-MIB2
DLINKSW-STORM-CTRL-MIB2
DLINKSW-WEB-AUTH-MIB2
PKT-STORM-CTRL-MIB2
SAFEGUARD-ENGINE-MIB2
DES-1210-28ME-B21
DES7200-ADDRESS-MIB1
DES7200-AUTH-GATEWAY-MIB1
DES7200-CLUSTER-MIB1
DES7200-DVMRPINTEROPERABILITY-MIB1
DES7200-IGMP-MIB1
DES7200-INTERFACE-MIB1
DES7200-PIM-MIB1
DES7200-SECURITY-MIB1
DES7200-TRAFFIC-CTRL-MIB1
DGS3324SR-SWL2MGMT-MIB1
DGS3324SRi-SWL2MGMT-MIB1
DLINKSW-DHCP-FILTER-MIB1
DLINKSW-GENMGMT-MIB1
DLINKSW-IMPB-MIB1
DLINKSW-IP-EXT-MIB1
DLINKSW-L2FDB-MIB1
DLINKSW-PORT-SECURITY-MIB1
DOS-PREV-MIB1
DXS3326GSR-SWL2MGMT-MIB1
DXS3350SR-SWL2MGMT-MIB1
FILTER-MIB1
SW-DES3x50-L2MGMT-MIB1

Sample decoded traps​

  • DES2218-MIB::linkChangeEvent
  • DES2218-MIB::portPartition
  • DES3225G-MIB::portPartition
  • DES3225G-MIB::linkChangeEvent
  • DES3225G-MIB::broadcastRisingStorm
Last updated on

Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.