Synology Disk Station

Plugin: go.d.plugin Module: snmp

Overview

Monitor Synology Disk Station (storage) with Netdata over SNMP. Netdata recognizes the device automatically by its sysObjectID (recognized across 1 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:

Method	Best for	How to
UI	Fast setup without editing files	Go to Nodes → Configure this node → Collectors → Jobs, search for snmp, then click + to add a job.
File	If 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.

33 metrics in 14 groups; each row is a chart context usable in alerts.

Group	Metrics
Hardware / Disk	4
Hardware / Fan	2
Hardware / Power	1
Hardware / Temperature	1
Network / Interface	4
Storage / IO	5
Storage / RAID	3
Storage / Volume	5
System / CPU	1
System / GPU	3
System / Service	1
System / Status	1
System / Upgrade	1
System / Uptime	1

Hardware / Disk

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_synology_diskSMARTAttrCurrent	1	per synology_disk_smart_info_dev_name, synology_disk_smart_attr_id	SMART attribute current value
snmp.device_prof_synology_diskSMARTAttrThreshold	1	per synology_disk_smart_info_dev_name, synology_disk_smart_attr_id	SMART attribute threshold value
snmp.device_prof_synology_diskStatus	{status}	per synology_disk_id, synology_disk_model, synology_disk_type	Disk status
snmp.device_prof_synology_diskTemperature	Cel	per synology_disk_id, synology_disk_model, synology_disk_type	The temperature of each disk uses Celsius degree

Hardware / Fan

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_synology_system_cpuFanStatus	{status}	device	CPU fan status
snmp.device_prof_synology_system_systemFanStatus	{status}	device	Fan status

Hardware / Power

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_synology_system_powerStatus	{status}	device	Power status

Hardware / Temperature

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_synology_system_temperature	Cel	device	The temperature of Disk Station

Network / Interface

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_ifAdminStatus	{status}	per interface, interface	Current administrative state of the interface
snmp.device_prof_ifHighSpeed	bit/s	per interface, interface	Estimate of the interface's current bandwidth
snmp.device_prof_ifNumber	{interface}	device	Number of network interfaces regardless of their current state present on this system
snmp.device_prof_ifOperStatus	{status}	per interface, interface	Current operational state of the interface

Storage / IO

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_synology_storageIOLA	%	per storage_io_device_index, synology_storage_io_device	The load of disk
snmp.device_prof_synology_storageIONReadX	By/s	per storage_io_device_index, synology_storage_io_device	The number of bytes read from this device since boot
snmp.device_prof_synology_storageIONWrittenX	By/s	per storage_io_device_index, synology_storage_io_device	The number of bytes written to this device since boot
snmp.device_prof_synology_storageIOReads	{access}/s	per storage_io_device_index, synology_storage_io_device	The number of read accesses from this device since boot
snmp.device_prof_synology_storageIOWrites	{access}/s	per storage_io_device_index, synology_storage_io_device	The number of write accesses to this device since boot

Storage / RAID

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_synology_raidFreeSize	By	per synology_raid_index, synology_raid_name	The free size of raid
snmp.device_prof_synology_raidTotalSize	By	per synology_raid_index, synology_raid_name	The total size of raid
snmp.device_prof_synology_raid_raidStatus	{status}	per synology_raid_index, synology_raid_name	Raid status

Storage / Volume

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_synology_spaceIOLA	%	per space_io_device_index, synology_space_io_device	The load of disk
snmp.device_prof_synology_spaceIONReadX	By/s	per space_io_device_index, synology_space_io_device	The number of bytes read from this device since boot
snmp.device_prof_synology_spaceIONWrittenX	By/s	per space_io_device_index, synology_space_io_device	The number of bytes written to this device since boot
snmp.device_prof_synology_spaceIOReads	{access}/s	per space_io_device_index, synology_space_io_device	The number of read accesses from this device since boot
snmp.device_prof_synology_spaceIOWrites	{access}/s	per space_io_device_index, synology_space_io_device	The number of write accesses to this device since boot

System / CPU

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cpu_usage	{load_average}	device	The 1,5 and 15 minute load averages

System / GPU

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_synology_gpuMemoryUtilization	%	device	GPU memory utilization
snmp.device_prof_synology_gpuUtilization	%	device	GPU utilization
snmp.device_prof_synology_system_gpuInfoSupported	{status}	device	GPU info support status

System / Service

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_synology_serviceUsers	{user}	per service_index, synology_service_name	Number of users using this service

System / Status

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_synology_system_systemStatus	{status}	device	System status

System / Upgrade

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_synology_system_upgradeAvailable	{status}	device	System upgrade availability

System / Uptime

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_systemUptime	s	device	Time since the system was last rebooted or powered on.