HYPHAby S33D
Documentation › Integrations

Network devices over SNMP

An agent queries the devices of its network and publishes them as full hosts. SNMP secrets never leave the agent.

Declare a device

In the configuration of an agent that reaches the device, preferably a conf.d/20-snmp.yaml file (mode 600):

snmp:
  enabled: true
  interval: 60s
  devices:
    # SNMP v2c
    - {name: rack-1-switch, address: 192.0.2.10, version: 2c, community: readonly, tags: {role: switch}}
    # SNMP v3, authentication and encryption
    - name: backup-nas
      address: 192.0.2.20
      version: 3
      user: hypha
      level: authPriv
      auth_protocol: sha        # md5, sha, sha224, sha256, sha384, sha512
      auth_key: "…"             # 8 characters at least
      priv_protocol: aes        # des, aes, aes192, aes256, aes192c, aes256c
      priv_key: "…"
      profile: auto

Other per-device settings: port (161), timeout (5 s), retries, context, interfaces_exclude (patterns), interface_down.

Advice:

Profiles

profile: auto reads sysObjectID and picks the profile:

ProfileWhat it adds
genericMIB-II, IF-MIB, HOST-RESOURCES-MIB: interfaces, CPU, memory, storage
mikrotikRouterOS CPU, temperatures, fans, power supplies
synologydisk, volume and RAID state
ASUSTOR (detected)temperatures, fans, disk state and temperature, volume state and usage; snmp.disk.health and snmp.volume.health checks
printerprinter state and supply levels
upsUPS-MIB: battery charge, runtime, output load

Metrics and checks

MetricUnit
snmp.ifBandwidthIn, .ifBandwidthOutbytes per second
snmp.ifBandwidthInUsage, .OutUsagepercent of the interface speed
snmp.ifInErrors, .ifOutErrors, .ifInDiscards, .ifOutDiscardspackets per second
snmp.ifOperStatus, snmp.ifAdminStatusstate
snmp.cpu.usage, snmp.memory.usage, snmp.storage.usagepercent
snmp.temperature, snmp.fan.speed, snmp.psu.statusdegrees, RPM, state
snmp.ups.battery.charge, .runtime, .loadpercent, seconds
snmp.sysUpTimeInstance, snmp.poll.durationseconds, milliseconds

Checks:

Traps

snmp:
  traps: {enabled: true, listen: "0.0.0.0:162", community: readonly}

Each v1 or v2c trap received becomes an event (source:snmp type:snmp_trap), 60 per minute at most. An "event" monitor can alert on them.

In the interface

Catalogue templates (Network family): network interface down, device unreachable.

Updated: 19 November 2026