Synology DiskStation MIB Guide
Synology DiskStation MIB Guide
MIB Guide
Synology Inc.
9F., No.1. Yuandong Rd., Banqiao Dist., New Taipei City
220, Taiwann
Chapter 1: Introduction
Synology_SNMP_MIB_Guide_20190416
Introduction
Synology DiskStation Manager (DSM) allows users to monitor the status of their Synology NAS through Network
Management Systems (NMS) via Simple Network Management Protocol (SNMP). However, Synology DSM does
not provide SNMP trap capability.
This document introduces Management Information Base (MIB) files of Synology NAS. It focuses on which MIB
files are supported by DSM, while also describes how Object Identifiers (OIDs) in Synology MIBs are used with
your preferred NMS software. Users are encouraged to have experience and knowledge of NMS and SNMP
before consulting this document.
DSM supports numerous MIB files that can help users monitor different information on their Synology NAS. Table
1 shows the MIBs supported by DSM.
These MIB files can be separated into two types: general SNMP MIB and Synology MIB. General SNMP MIB files
are equipped on NMS clients natively. This document does not explain the OIDs of general SNMP MIB files. If
you would like to learn more about OIDs in general SNMP MIB files, please visit this website.
Synology MIB files can provide specific data about a Synology NAS’s system, disks, RAID, and connected UPS
devices. Please see the “Synology MIB Files” section below for more Synology MIB information.
To download the Synology MIB file, please use the link below:
• https://global.download.synology.com/download/Document/MIBGuide/Synology_MIB_File.zip
MIB Explanation
DISMAN-EVENT-MIB For defining event triggers and actions for network management
purposes
DISMAN-SCHEDULE-MIB For scheduling SNMP set operations periodically or at specific
points in time
HOST-RESOURCES-MIB For use in managing host systems
IF-MIB For describing network interface sub-layers
IP-FORWARD-MIB For the management of CIDR multipath IP Routes
IP-MIB For IP and ICMP management objects
IPV6-ICMP-MIB For entities implementing the ICMPv6
IPV6-MIB For entities implementing the IPv6 protocol
IPV6-TCP-MIB For entities implementing TCP over IPv6
IPV6-UDP-MIB For entities implementing UDP over IPv6
NET-SNMP-AGENT-MIB For monitoring structures for the Net-SNMP agent
NET-SNMP-EXTEND-MIB For scripted extensions for the Net-SNMP agent
NET-SNMP-VACM-MIB Defines Net-SNMP extensions to the standard VACM view table
NOTIFICATION-LOG-MIB For logging SNMP Notifications
SNMP-COMMUNITY-MIB To help support coexistence between SNMPv1, SNMPv2c, and SNMPv3
SNMP-FRAMEWORK-MIB The SNMP Management Architecture MIB
SNMP-MPD-MIB For Message Processing and Dispatching
SNMP-USER-BASED-SM-MIB For the SNMP User-based Security Model
SNMP-VIEW-BASED-ACM-MIB For the View-based Access Control Model for SNMP
SNMPv2-MIB For SNMP entities
SYNOLOGY-DISK-MIB For Synology disk information (Synology only)
SYNOLOGY-EBOX-MIB For Synology ebox information (Synology only)
SYNOLOGY-FLASHCACHE-MIB For Synology FlashCache information (Synology only)
SYNOLOGY-ISCSILUN-MIB For Synology iSCSI LUN information (Synology only)
SYNOLOGY-RAID-MIB For Synology RAID information (Synology only)
SYNOLOGY-SERVICES-MIB For Synology services information (Synology only)
SYNOLOGY-SHA-MIB For Synology High-Availability information (Synology only)
SYNOLOGY-SMART-MIB For Synology smart information (Synology only)
SYNOLOGY-SPACEIO-MIB For Synology SpaceIO information (Synology only)
SYNOLOGY-STORAGEIO-MIB For Synology StorageIO information (Synology only)
SYNOLOGY-SYSTEM-MIB For Synology system information (Synology only)
SYNOLOGY-UPS-MIB For Synology UPS information (Synology only)
TCP-MIB For managing TCP implementations
UCD-DISKIO-MIB For disk IO statistics
UCD-DLMOD-MIB For dynamic loadable MIB modules
UCD-SNMP-MIB For private UCD SNMP MIB extensions
UDP-MIB For managing UDP implementations
5 Chapter 2: Supported MIB Files © 2015-2019 Synology Inc. All rights reserved.
3
Chapter
The following Synology MIB files are provided in DSM. These MIB files are the child-nodes of OID (Object
Identifier) 1.3.6.1.4.1.6574. Table 2 shows the exact OID of each MIB. Please note that the MIB files are mutually
dependent. Before your NMS can monitor any of the items in these MIB files, please make sure that all of them
have been imported together and use SNMPv2c to obtain the complete Synology OID information.
Table 2. OID of Synology MIBs
6 Chapter 3: Synology MIB Files © 2015-2019 Synology Inc. All rights reserved.
Synology Disk MIB
The Synology Disk MIB contains several types of information regarding hard drives, including ID, type and so
on, as listed in Table 4. This MIB is a table in SNMP. As such, it can increase or decrease in size when disks
are inserted or removed. For example, if a disk is inserted, an additional row containing relevant information will
emerge. The OID DiskIndex (.1) is reserved for an index of table rows and cannot be accessed. Table 5 describes
the contents of each DiskStatus in detail.
Table 4. Disk MIB
Status Explanation
Normal(1) The disk is functioning normally
Initialized(2) The disk has system partitions but no data
NotInitialized(3) The disk is not partitioned
SystemPartitionFailed(4) Partitions on the disk are damaged
Crashed(5) The disk is damaged
Status Explanation
Normal(1) RAID is functioning normally
Repairing(2)
Migrating(3)
Expanding(4)
Deleting(5)
Creating(6) These statuses are shown when RAID is created or deleted
RaidSyncing(7)
RaidParityChecking(8)
RaidAssembling(9)
Canceling(10)
7 Chapter 3: Synology MIB Files © 2015-2019 Synology Inc. All rights reserved.
Status Explanation
Degrade(11) Degrade is shown when a tolerable failure of disk(s)
occurs
Crashed(12) RAID has crashed and is now read-only
DataScrubbing (13) RAID is DataScrubbing
RaidDeploying (14) RAID is deploying Single volume on pool
RaidUnDeploying (15) RAID is not deploying Single volume on pool
RaidMountCache (16) RAID is mounting SSD cache
RaidUnmountCache (17) RAID is not mounting SSD cache
RaidExpandingUnfinishedSHR (18) RAID continue expanding SHR if interrupted
RaidConvertSHRToPool (19) RAID is converting Single volume on SHR to multiple
volume on SHR
RaidMigrateSHR1ToSHR2 (20) RAID is migrating SHR1 to SHR2
RaidUnknownStatus (21) RAID status is not included in the status above
8 Chapter 3: Synology MIB Files © 2015-2019 Synology Inc. All rights reserved.
Synology Services MIB
The Synology Services MIB monitors the number of users logging in via HTTP, CIFS, AFP, FTP, SFTP, TELNET,
and SSH.
Table 10. Services MIB
9 Chapter 3: Synology MIB Files © 2015-2019 Synology Inc. All rights reserved.
OID Name Type Status Type Explanation
.4 spaceIONWritten Counter32 - The number of bytes written to
this volume since boot
(32 bit VER.)
.5 spaceIOReads Counter32 - The number of read accesses
from this volume since boot
.6 spaceIOWrites Counter32 - The number of write accesses
to this volume since boot
.8 spaceIOLA Integer - The load of disk in the volume
(%)
.9 spaceIOLA1 Integer - The 1 minute average load of
disk in the volume (%)
.10 spaceIOLA5 Integer - The 5 minute average load of
disk in the volume (%)
.11 spaceIOLA15 Integer - The 15 minute average load of
disk in the volume (%)
.12 spaceIONReadX Counter64 - The number of bytes read from
this volume since boot
(64 bit VER.)
.13 spaceIONWrittenX Counter64 - The number of bytes written to
this volume since boot
(64 bit VER.)
Note: The MIB is only suitable for the model which support SSD cache. Otherwise, it will return zero value for
each OID path.
Table 13. FlashCache MIB
10 Chapter 3: Synology MIB Files © 2015-2019 Synology Inc. All rights reserved.
Synology iSCSI LUN MIB
The Synology iSCSI LUN MIB can list all the loaded LUNs and show their running information. If a LUN has been
created but not loaded (e.g. when linked to a target), it will not appear in this list. The throughput value may be
over int32 range, so we use two i to record it.
Table 14. iSCSI LUN MIB
Status Explanation
Normal (1) The power supplies well
Poor (2) The power supplies badly
Disconnection (3) The power is not connected
11 Chapter 3: Synology MIB Files © 2015-2019 Synology Inc. All rights reserved.
Synology SHA MIB
The Synology SHA MIB provides basic cluster information and monitors cluster status and heartbeat status.
Table 17. SHA MIB
Status Explanation
normal (0) The High-Availability cluster is healthy
warning (1) The High-Availability cluster has something went wrong.
Action should be taken to resume High-Availability feature.
Please refer to High-Availability Manager for more details.
critical (2) The High-Availability cluster is in danger, and should be
resolved as soon as possible.
Please refer to High-Availability Manager for more details.
upgrading (3) The High-Availability cluster is upgrading.
processing (4) The High-Availability cluster is undergoing some operation.
Status Explanation
normal (0) The heartbeat connection is normal.
abnormal (1) Some information about heartbeat is not available.
disconnected (2) The High-Availability cluster loses connection to passive
server through heartbeat interface, or it is currently in
split-brain mode.
empty (3) The High-Availability cluster has no passive server.
12 Chapter 3: Synology MIB Files © 2015-2019 Synology Inc. All rights reserved.
4
Chapter
Useful OIDs
Although there are many native MIB files supported by Synology, user may be interested in specific information
about the Synology NAS, such as CPU, memory and so on. The tables below list the native OIDs related to load,
CPU, memory, network and disk for gathering useful device’s data easily.
Table 18. CPU-Related OID
In any NMS, particular MIB files are needed in order to capture data through SNMP. Users need to import all MIB
files to ensure that the NMS can resolve specific OIDs. Once imported, data can be captured by setting up the
NMS. Although the means of operating different kinds of NMS may vary, the process of OID monitoring is similar.
The overall procedure is as follows.
The following guide demonstrates the usage of PRTG (a type of NMS) including how to import MIB files and set
up monitoring for the provided OIDs. For further help regarding PRTG, please consult PRTG documentation, as
the following is only intended to be a brief description of OID monitoring.
your computer.
3. Choose all the Synology MIB file together and click Open File.
All MIB files (cf. Table 2) must be imported together as they are mutually dependent and Paessler MIB Importer
cannot load them individually. If the import is successful, a window as shown in Figure 1 should appear. Detailed
information is shown in Figure 2.
15 Chapter 5: Monitor Specific OIDs © 2015-2019 Synology Inc. All rights reserved.
Figure 2. Detailed Information on MIB
16 Chapter 5: Monitor Specific OIDs © 2015-2019 Synology Inc. All rights reserved.
3. Click Add sensor to an existing device and choose a device.
4. Choose SNMP Library and the library exported in the previous section.
17 Chapter 5: Monitor Specific OIDs © 2015-2019 Synology Inc. All rights reserved.
6
Chapter
This table describes the revisions made to Synology NAS MIB Guide.
Table 26. Document Revision History
Date Note
2012-07-19 Document created
2013-10-29 Modified OID name and added UPS MIB
2013-11-04 Added more MIBs and useful OID
2016-10-31 Added more MIBs
2018-06-30 Added Ebox MIB
Added useful OIDs in RAID MIB
2018-12-18 Added FlashCache MIB
2018-12-24 Added SHA MIB
18 Chapter 6: Document Revision History © 2015-2019 Synology Inc. All rights reserved.