Community

banshee is under active development: collectors will keep changing, and a version you publish will likely need adjustments. For stable use, wait for version 1.0.0.

Storage

banshee/storage-collection/storage/synology/snmp/

volumes

The used and free space of each volume of a Synology NAS by SNMP (HOST-RESOURCES-MIB).

  • storage
  • synology
  • dsm
  • nas
  • volume
  • snmp
  • disk

by banshee1 installation2 versions

v2Latest

Published on October 28, 2026. One naming convention across collections; documentation completed.

Volumes of a Synology NAS, by SNMP

Returns, for each volume of a Synology NAS (/volume1, /volume2…), its used space, its free space and its size. Four watches are offered, each one set on the probe.

Versions

Generic: HOST-RESOURCES-MIB is the standard MIB that Synology's SNMP MIB guide gives for the disk space of DSM, from DSM 6.2.4. It stays at the common level.

How it works

The collector reads hrStorageTable (1.3.6.1.2.1.25.2.3.1) and keeps the mounts named /volume followed by a number:

ColumnOIDRead as
hrStorageDescr.3the mount point, the instance
hrStorageAllocationUnits.4bytes per unit
hrStorageSize, hrStorageUsed.5, .6counts of units
  • The used space is used over size, as DSM's file system counts it.
  • The other mounts of the table (memory, the system partition /, USB disks under /volumeUSB1) are left out.
  • The collector only reads: SNMP sends nothing but reads.

Prerequisites

  • The SNMP service of DSM enabled (Control Panel, Terminal & SNMP, SNMP), reachable from the poller (UDP 161), its access restricted to the poller.
  • The view granted to the poller includes host (.1.3.6.1.2.1.25).
  • Read-only access, SNMPv2c or SNMPv3, set on the host or one of its folders (protocol:snmp:* variables).

Outputs

NameLabelUnitPer instance
used-percentUsed space%yes, per volume
freeFree spaceGiByes, per volume
sizeSizeGiByes, per volume

Watches

NameTitleKindDefaultsChecked by default
usedUsed spaceabove a threshold, on used-percentwarning above 80 %, critical above 90 %yes
full-soonFull within a weekabove a threshold, on used-percentwarning above 99 %, ahead 7 dyes
freeLittle free spacebelow a threshold, on freecritical below 10 GiBno
missingVolume missingexpected instances, on used-percentno volume named: it raises nothing until names are set on the probeno

Limits

  • A volume that crashes and is unmounted leaves the table: it is seen through missing, once its name is set, and by storage/synology/snmp/raid.
  • A NAS with no volume, or a view without host, stops the collector misconfigured.
  • Not checked against a Synology: the OIDs are those of HOST-RESOURCES-MIB (RFC 2790) that Synology's SNMP MIB guide lists (last updated 2026-08-03); that DSM names its volumes /volume1 in hrStorageDescr is not written in the guide.