check_synology

This plugin uses python3 & easysnmp with MD5 + AES to check a lot of different values on your Synology DiskStation.

This check plugin needs easysnmp to be installed on your system. You can install it with: pip3 install easysnmp

Usage:

> python3 check_synology.py -h
usage: check_synology.py hostname username authkey privkey {mode} [-h] [-w W] [-c C]

Example check:

> python3 check_synology.py hostname snmp_user auth_key priv_key load
OK - load average: 1.48, 1.71, 1.74 | load1=1.48c load5=1.71c load15=1.74c

Available modes:

mode	description	warning/critical
load	Checks the load1, load5 and load15 values	if more than w/c in int (only load1)
memory	Checks the physical installed memory (free and total)	if less free than w/c in %
disk	Detects and checks all disks (name, status, temperature)	if temp higher than w/c in °C if c is set it will also trigger if status is Failure or Crashed
storage	Detects and checks all disks (free, total, %)	if more used than w/c in %
update	Shows the current DSM version and if DSM update is available	set w/c to any int this triggers: warning if available and critical if other than un-/available
status	Shows model, s/n, temp and status of system, fan, cpu fan and power supply	if temp higher than w/c in °C

Example CheckCommand for use with icinga2:

object CheckCommand "check_synology" {
  command = ["/usr/bin/python3", PluginDir + "/check_synology.py" ]

  arguments = {
    "--host" = {
       skip_key = true
       order = 0
       value = "$synology_host$"
    }
    "--username" = {
       skip_key = true
       order = 1
       value = "$synology_snmp_user$"
    }
    "--authkey" = {
       skip_key = true
       order = 2
       value = "$synology_snmp_authkey$"
    }
    "--privkey" = {
       skip_key = true
       order = 3
       value = "$synology_snmp_privkey$"
    }
    "--mode" = {
       skip_key = true
       order = 4
       value = "$synology_mode$"
    }
    "-w" = "$synology_warning$"
    "-c" = "$synology_critical$"
  }
}

Example Service for use with icinga2:

apply Service "syno-load" {
  import "generic-service"

  check_command = "check_synology"

  vars.synology_mode = "load"
  vars.synology_host = "$address$"
  
  vars.synology_warning = "$synology_load_w$"
  vars.synology_critical = "$synology_load_c$"

  assign where host.vars.os == "DSM"
}

Make sure to set synology_snmp_user, synology_snmp_autkey and synology_snmp_privkey (e.g. in the host config file).

If you want to add a missing check or another value to be added than you can use the official Synology MIB Guide as a hint for the right MIBs / OIDs and start a pull-request.

This plugin was tested successfully with DS215j and DS718+