Tools

Account Tools

Search Tools


List of services available with ESIA Unity

Service names

The naming of services within Esia Unity follows a certain pattern: <méthode de connexion>_<protocole>_<plateforme>_<service testé>

For example :

GESA_SNMP_WINDOWS_STORAGE
  • GESA: test via the ESIA Unity box.
  • SNMP: uses the SNMP protocol.
  • WINDOWS: for all Windows OS.
  • STORAGE: tests the storage space used on a drive.

Another example :

CHECK_HTTPS
  • CHECK: test directly from the server
  • HTTPS: if an HTTPS server is present

Basic tests

CHECK_ICMP

Tests the ping of a node. Also provides network latency information. This service is run from the server, so testing a local address such as 192.168.1.1 will not work. In this case, you need to use GESA_ICMP.

Parameter Description
-H <host> The IP address or name of the host to be tested
-w <latences ms>,< % de paquet perdu> Indicates the alert threshold in ms and in % of lost packets
-c <latences ms>,< % de paquet perdu> Indicates the critical threshold in ms and in % of packets lost

Example:

-H google.be -w 200,50 -c 300,100

Output :

OK - google.be: rta 28,629ms, lost 0%|rta=28,629ms;200,000;300,000;0; pl=0%;40;80;;rtmax=28,742ms;;;; rtmin=28,473ms;;;;

GESA_ICMP

Tests via a Unity box whether the node responds to the ping. Also provides network latency.

Parameter Description
-H <host> Host name (default $NRPE_HOST)
-p <port nrpe> nrpe port (default 5666)
-u If there is a connection error to the Unity box, this returns the status unknown.
-t 50 Timeout (in this case 50 seconds)
-c <nom du service> Name of the service to be tested
-a <liste des arguments> List of check_icmp arguments
$IP IP address of the host under test (default&nbsp:$IP)
200,50 % Alert threshold: 200ms latency and 50% loss
500,100 % 500ms latency and 100% loss

Example:

-H saloc.no-ip.info -p 5666 -u -t 50 -c check_icmp -a 10.7.0.9 200,50% 500,100%

Output :

OK - 10.7.0.9: rta 0.826ms, lost 0%|rta=0.826ms;200.000;500.000;0; pl=0%;50;100;;rtmax=0.987ms;;;; rtmin=0.730ms;;;;

NAS tests

Synology

GESA_SNMP_SYNOLOGY

Test the health of a Synology NAS (SYNOLOGY-MIB compatible) using a Unity box.

This plugin retrieves and checks :

  • The model, serial number and system name are displayed.
  • Display of the system version
  • General system status (power supply, fan, etc.)
  • System temperature
  • CPU temperature
  • Disk status (model, capacity, smart status and temperature)
  • RAID volume status
Parameter Description
-H <host> Host name (default $NRPE_HOST)
-p <port nrpe> nrpe port (default 5666)
-u If there is a connection error to the Unity box, this returns the status unknown.
-t 50 Timeout (in this case 50 seconds)
-c check_snmp_synology Name of the service to be tested
-a <liste des arguments> List of check_icmp arguments
$IP IP address of the host under test (default&nbsp:$IP)
$SNMP_COM SNMP community

Example:

-H saloc.no-ip.info -p 5666 -u -t 50 -c check_snmp_synology -a 192.168.1.22 public 50 70

Output :

Synology model: "RS814+"
Synology s/n: "14B0MAN597000"
DSM Version: "DSM 5.1-5022"
System Status: Normal
Power Status: Normal
System Fan Status: Normal
CPU Fan Status: Normal
Number of disks: 4
"Disk 1" (model: "WD10EZEX-00RKKA0 ") status:Normal temperature:24 C
"Disk 2" (model: "WD10EZEX-00RKKA0 ") status:Normal temperature:25 C
"Disk 3" (model: "ST1000DM003-1CH162 ") status:Normal temperature:24 C
"Disk 4" (model: "ST1000DM003-1CH162 ") status:Normal temperature:23 C
Number of RAID volume: 1
"Volume 1" status:Normal
OK - Synology "RS814+" (s/n: "14B0MAN597000", "DSM 5.1-5022") is in good health

GESA_SNMP_SYNOLOGY_UPS

Tests, via a Unity box, the health of a UPS compatible with Synology NAS (see manufacturer's documentation). The Synology UPS server must be activated.

This plugin retrieves and checks :

  • The model, serial number and manufacturer of the UPS.
  • The load on the UPS
  • The % of electricity remaining in the batteries
Parameter Description
-H <host> Host name (default $NRPE_HOST)
-p <port nrpe> nrpe port (default 5666)
-u If there is a connection error to the Unity box, this returns the status unknown.
-t 50 Timeout (in this case 50 seconds)
-c check_snmp_synology Name of the service to be tested
-a <liste des arguments> List of check_icmp arguments
$IP IP address of the host under test (default&nbsp:$IP)
$SNMP_COM SNMP community
70 % battery remaining threshold before generating an alert
40 battery remaining threshold before generating a critical alert
40 % UPS charging alert threshold
50 critical alert threshold for UPS load

Example:

-H saloc.no-ip.info -p 5666 -u -t 50 -c check_snmp_synology_ups -a 192.168.1.22 public 70 40 40 50

Output :

Manufacturer: APC Model: Back-UPS ES 700G SN: 5B1447T01285
OK: UPS load: 5% < 50%
OK: Battery type: PbAc charge: 100 % > 70%

QNAP

GESA_SNMP_QNAP_HEALTH

Tests the health of a QNAP NAS (QNAP NAS-MIB compatible) using a Unity box.

This plugin retrieves and checks :

  • Display of the model and system name
  • System temperature
  • CPU temperature
  • Disk status (model, capacity, smart status and temperature)
  • RAID volume status
Parameter Description
-H <host> Host name (default $NRPE_HOST)
-p <port nrpe> nrpe port (default 5666)
-u If there is a connection error to the Unity box, this returns the status.
-t 50 Timeout (in this case 50 seconds)
-c check_snmp_synology Name of the service to be tested
-a <liste des arguments> List of check_icmp arguments
$IP IP address of the host under test (default&nbsp:$IP)
$SNMP_COM SNMP community
50 The system alert temperature.
70 Critical system temperature.

Example:

-H saloc.no-ip.info -p 5666 -u -t 50 -c check_snmp_qnap_health -a 192.168.1.22 public 50 70

Output :

Model: HS-210 Hostname: NASDF8958
OK: System temperature: 43 C/109 F < 50 C
OK: CPU temperature: noInfo
OK: DISK 1 : HDD1 (Model: ST1000DM003-1CH1 Capacity: 931.51 GB) status is: ready (SMART:GOOD) . Temperature is 39 C/102 F
OK: DISK 2 : HDD1 (Model: ST1000DM003-1CH1 Capacity: 931.51 GB) status is: ready (SMART:GOOD) . Temperature is 40 C/104 F
WARNING: Volume 1 software raid status is Rebuilding.

GESA_SNMP_QNAP_STORAGE

Uses a Unity box to test the disk space available on the various volumes of a QNAP NAS.

This plugin retrieves and checks:

  • Remaining disk space
  • Used space
  • Total space
  • Partition type
Parameter Description
-H <host> Host name (default $NRPE_HOST)
-p <port nrpe> nrpe port (default 5666)
-u If there is a connection error to the Unity box, this returns the status unknown.
-t 50 Timeout (in this case 50 seconds)
-c check_snmp_synology Name of the service to be tested
-a <liste des arguments> List of check_icmp arguments
$IP IP address of the host under test (default&nbsp:$IP)
$SNMP_COM SNMP community
80 The alert threshold in % of disk space used.
90 The critical threshold in % of disk space used.

Example:

-H saloc.no-ip.info -p 5666 -u -t 50 -c check_snmp_qnap_storage -a 192.168.1.22 public 80 90

Output :

OK: Volume 1 : [Single Disk Volume: Drive 1] (EXT4) used 22.84% (209.07 GB/ 915.42 GB) < 80

Printer tests

GESA_SNMP_PRINTER

Tests the general status of an SNMP MIB-compatible printer via a Unity box.

This plugin retrieves and checks :

  • Printer status (paper jam, cover open, out of paper, etc)
  • Its system description (model, SN, etc)
  • The status of each consumable
Parameter Description
-H <host> Host name (default $NRPE_HOST)
-p <port nrpe> nrpe port (default 5666)
-u If there is a connection error to the Unity box, this returns the status unknown.
-t 50 Timeout (in this case 50 seconds)
-c check_snmp_synology Name of the service to be tested
-a <liste des arguments> List of check_icmp arguments
$IP IP address of the host under test (default&nbsp:$IP)
$SNMP_COM SNMP community
20 The alert threshold in % remaining of the consumable level.
10 The critical threshold in % of the remaining level of consumables.

Example:

-H saloc.no-ip.info -p 5666 -u -t 50 -c check_snmp_printer -a 192.168.1.22 public 20 10

Output :

Printer is OK
Description: HP ETHERNET MULTI-ENVIRONMENT,SN:CND8FBTBLB,FN:SF45SDW,SVCID:24014,PID:HP LaserJet 400 colorMFP M475dw
CRITICAL : 2. Description: Cyan Cartridge HP CE411A (cyan) State: 3% <= 10%
OK : 3. Description: Magenta Cartridge HP CE413A (magenta) State: 99%
OK : 1. Description: Black Cartridge HP CE410X (black) State: 72%
CRITICAL : 4. Description: Yellow Cartridge HP CE412A (yellow) State: 3% <= 10%
en/intro/liste_services_unity.txt · Last modified: 2023/11/09 18:27 by 127.0.0.1