Table of Contents
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 :$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 :$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 :$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 :$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 :$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 :$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%