Skip to main content

Synology Disk Station

Synology Disk Station

Plugin: go.d.plugin Module: snmp

Maintained by Netdata

Overview​

Monitor Synology Disk Station (storage) with Netdata over SNMP. Netdata recognizes the device automatically by its sysObjectID (recognized across 2 device identifiers) and collects the metrics this profile declares — on top of the generic SNMP baseline — with no manual OID configuration.

Netdata's SNMP collector matches the device to the synology-disk-station.yaml profile via sysObjectID/sysDescr, then polls the OIDs it declares.

This integration is supported on all platforms.

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

Default Behavior​

Auto-Detection​

Auto-detected as Synology Disk Station via sysObjectID/sysDescr.

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 collector in two ways:

MethodBest forHow to
UIFast setup without editing filesGo to Nodes → Configure this node → Collectors → Jobs, search for snmp, 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.conf and add a job.
important

UI configuration requires paid Netdata Cloud plan.

Prerequisites​

SNMP access​

SNMP must be enabled on the device and reachable from the Netdata Agent acting as the site's SNMP hub.

Configuration​

Options​

Configure the SNMP collector with the device hostname and SNMP credentials. See the SNMP collector reference for all options.

via UI​

Configure the snmp collector from the Netdata web interface:

  1. Go to Nodes.
  2. Select the node where you want the snmp 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 (or scroll the list) to locate the snmp collector.
  5. Click the + next to the snmp 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.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.conf
Examples​

There are no configuration examples.

Alerts​

There are no alerts configured by default for this integration.

Metrics​

On top of the generic SNMP baseline (the Generic SNMP Device integration — interfaces, system, IP/TCP/UDP, host resources), this Synology Disk Station profile adds the metrics below. Each is collected only where the device exposes the matching OID — inclusion means the profile requests it; availability depends on the device model and software.

34 metrics in 15 groups; each row is a chart context usable in alerts.

GroupMetrics
Hardware / Disk4
Hardware / Fan2
Hardware / Power1
Hardware / Temperature1
Network / Interface4
Storage / IO5
Storage / RAID3
Storage / Volume5
System / CPU1
System / GPU3
System / Memory1
System / Service1
System / Status1
System / Upgrade1
System / Uptime1

Hardware / Disk​

Metric (chart context)UnitScopeDescription
snmp.device_prof_synology_diskSMARTAttrCurrent1per synology_disk_smart_info_dev_name, synology_disk_smart_attr_idSMART attribute current value
snmp.device_prof_synology_diskSMARTAttrThreshold1per synology_disk_smart_info_dev_name, synology_disk_smart_attr_idSMART attribute threshold value
snmp.device_prof_synology_diskStatus{status}per synology_disk_id, synology_disk_model, synology_disk_typeDisk status
snmp.device_prof_synology_diskTemperatureCelper synology_disk_id, synology_disk_model, synology_disk_typeThe temperature of each disk uses Celsius degree

Hardware / Fan​

Metric (chart context)UnitScopeDescription
snmp.device_prof_synology_system_cpuFanStatus{status}deviceCPU fan status
snmp.device_prof_synology_system_systemFanStatus{status}deviceFan status

Hardware / Power​

Metric (chart context)UnitScopeDescription
snmp.device_prof_synology_system_powerStatus{status}devicePower status

Hardware / Temperature​

Metric (chart context)UnitScopeDescription
snmp.device_prof_synology_system_temperatureCeldeviceThe temperature of Disk Station

Network / Interface​

Metric (chart context)UnitScopeDescription
snmp.device_prof_ifAdminStatus{status}per interface, interfaceCurrent administrative state of the interface
snmp.device_prof_ifHighSpeedbit/sper interface, interfaceEstimate of the interface's current bandwidth
snmp.device_prof_ifNumber{interface}deviceNumber of network interfaces regardless of their current state present on this system
snmp.device_prof_ifOperStatus{status}per interface, interfaceCurrent operational state of the interface

Storage / IO​

Metric (chart context)UnitScopeDescription
snmp.device_prof_synology_storageIOLA%per storage_io_device_index, synology_storage_io_deviceThe load of disk
snmp.device_prof_synology_storageIONReadXBy/sper storage_io_device_index, synology_storage_io_deviceThe number of bytes read from this device since boot
snmp.device_prof_synology_storageIONWrittenXBy/sper storage_io_device_index, synology_storage_io_deviceThe number of bytes written to this device since boot
snmp.device_prof_synology_storageIOReads{access}/sper storage_io_device_index, synology_storage_io_deviceThe number of read accesses from this device since boot
snmp.device_prof_synology_storageIOWrites{access}/sper storage_io_device_index, synology_storage_io_deviceThe number of write accesses to this device since boot

Storage / RAID​

Metric (chart context)UnitScopeDescription
snmp.device_prof_synology_raidFreeSizeByper synology_raid_index, synology_raid_nameThe free size of raid
snmp.device_prof_synology_raidTotalSizeByper synology_raid_index, synology_raid_nameThe total size of raid
snmp.device_prof_synology_raid_raidStatus{status}per synology_raid_index, synology_raid_nameRaid status

Storage / Volume​

Metric (chart context)UnitScopeDescription
snmp.device_prof_synology_spaceIOLA%per space_io_device_index, synology_space_io_deviceThe load of disk
snmp.device_prof_synology_spaceIONReadXBy/sper space_io_device_index, synology_space_io_deviceThe number of bytes read from this device since boot
snmp.device_prof_synology_spaceIONWrittenXBy/sper space_io_device_index, synology_space_io_deviceThe number of bytes written to this device since boot
snmp.device_prof_synology_spaceIOReads{access}/sper space_io_device_index, synology_space_io_deviceThe number of read accesses from this device since boot
snmp.device_prof_synology_spaceIOWrites{access}/sper space_io_device_index, synology_space_io_deviceThe number of write accesses to this device since boot

System / CPU​

Metric (chart context)UnitScopeDescription
snmp.device_prof_cpu_usage%deviceThe current CPU utilization

System / GPU​

Metric (chart context)UnitScopeDescription
snmp.device_prof_synology_gpuMemoryUtilization%deviceGPU memory utilization
snmp.device_prof_synology_gpuUtilization%deviceGPU utilization
snmp.device_prof_synology_system_gpuInfoSupported{status}deviceGPU info support status

System / Memory​

Metric (chart context)UnitScopeDescription
snmp.device_prof_memory_usage%deviceMemory utilization

System / Service​

Metric (chart context)UnitScopeDescription
snmp.device_prof_synology_serviceUsers{user}per service_index, synology_service_nameNumber of users using this service

System / Status​

Metric (chart context)UnitScopeDescription
snmp.device_prof_synology_system_systemStatus{status}deviceSystem status

System / Upgrade​

Metric (chart context)UnitScopeDescription
snmp.device_prof_synology_system_upgradeAvailable{status}deviceSystem upgrade availability

System / Uptime​

Metric (chart context)UnitScopeDescription
snmp.device_prof_systemUptimesdeviceTime since the system was last rebooted or powered on.

Troubleshooting​

Other Problems​

Collect Diagnostics for Netdata Support​

For SNMP metrics, BGP, licensing, or topology issues, follow Collect SNMP troubleshooting data to include built-in diagnostics in a support bundle. SNMP evidence is unsanitized; share the bundle through a restricted Netdata Support ticket.


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