Aller au contenu principal

Dell ME4 Rest API

Contenu du Pack​

Objets supervisés​

Le Pack Dell ME4 collecte les données pour:

  • Controllers
  • Hardware
  • Interfaces
  • Volumes

Règles de découvertes​

Nom de la règleDescription
HW-Storage-Dell-Me4-Restapi-Controller-Statistics-NameDécouvre les contrôleurs et supervise les statistiques
HW-Storage-Dell-Me4-Restapi-Volume-Statistics-NameDécouvre les volumes et supervise les statistiques

Métriques collectées​

Metric nameDescriptionUnit
controller_id#controller.data.read.bytespersecondAmount of data readB/s
controller_id#controller.data.written.bytespersecondAmount of data writtenB/s
controller_id#controller.reads.persecondFor the controller whose host ports had I/O activity, the number of read operations
controller_id#controller.writes.persecondFor the controller whose host ports had I/O activity, the number of write operations
controller_id#controller.data.transfer.bytespersecondThe data transfer rateB/s
controller_id#controller.iops.countInput/output operations per second
controller_id#controller.commands.forwarded.countThe current count of commands that are being forwarded or are queued to be forwarded to the partner controller for processing
controller_id#controller.cache.write.usage.percentagePercentage of write cache in use%
controller_id#controller.cache.write.hits.persecondFor the controller that owns the volume, the number of times the block written to is found in cache
controller_id#controller.cache.write.misses.persecondFor the controller that owns the volume, the number of times the block written to is not found in cache
controller_id#controller.cache.read.hits.persecondFor the controller that owns the volume, the number of times the block to be read is found in cache
controller_id#controller.cache.read.misses.persecondFor the controller that owns the volume, the number of times the block to be read is not found in cache
controller_id#controller.cpu.utilization.percentagePercentage of time the CPU is busy%

Prérequis​

Afin de contrôler votre équipement Dell ME4, l'API Rest doit être configuré (cf: https://www.dell.com/support/manuals/fr-fr/powervault-me4024/me4_series_cli_pub/using-a-script-to-access-the-cli?guid=guid-9ae5ccd6-a207-42df-b2f3-1e02a487a354&lang=en-us)

Installation​

  1. Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Hardware-Storage-Dell-Me4-Restapi
  1. Sur l'interface Web de Centreon, installer le Pack Dell Me4 Rest API depuis la page Configuration > Gestionnaire de connecteurs de supervision

Configuration​

  • Ajoutez un nouvel Hôte depuis la page Configuration > Hôtes
  • Complétez les champs Adresse IP/DNS, Communauté SNMP et Version SNMP
  • Appliquez le Modèle d'Hôte HW-Storage-Dell-Me4-Restapi-custom

Une fois celui-ci configuré, certaines macros doivent être renseignées:

MandatoryNameDescription
XAPIPORTPort used (Default: 443)
XAPIPROTOSpecify https if needed (Default: 'https')
XAPIUSERNAMEApi username
XAPIPASSWORDApi password
APIEXTRAOPTIONSAny extra option you may want to add to the command (eg. a --verbose flag)

Comment puis-je tester le Plugin et que signifient les options des commandes ?​

Une fois le Plugin installé, vous pouvez tester celui-ci directement en ligne de commande depuis un collecteur Centreon en vous connectant avec l'utilisateur centreon-engine:

/usr/lib/centreon/plugins/centreon_dell_me4_restapi.pl \
    --plugin=storage::dell::me4::restapi::plugin \
    --mode=interfaces \
    --hostname='10.30.2.79' \
    --port='443' \
    --proto='https' \
    --api-username='myapiusername' \
    --api-password='myapipassword' \
    --filter-port-name='A0' \
    --verbose

La commande devrait retourner un message de sortie de la forme ci-dessous:

OK: port 'A0' status: up [health: ok], read iops: 94.52, write iops: 161.11, read traffic: 1.29 Mb/s - All interfaces are ok | 'A0#port.io.read.usage.iops'=94.52iops;;;0; 'A0#port.io.write.usage.iops'=161.11iops;;;0; 'A0#port.traffic.read.usage.bitspersecond'=1287234b/s;;;0; 'A0~0#port.interface.disparity.errors.count'=0;;;0; 'A0~0#port.interface.lost.dwords.count'=0;;;0; 'A0~0#port.interface.invalid.dwords.count'=0;;;0; 'A0~1#port.interface.disparity.errors.count'=0;;;0; 'A0~1#port.interface.lost.dwords.count'=0;;;0; 'A0~1#port.interface.invalid.dwords.count'=0;;;0; 'A0~2#port.interface.disparity.errors.count'=0;;;0; 'A0~2#port.interface.lost.dwords.count'=0;;;0; 'A0~2#port.interface.invalid.dwords.count'=0;;;0; 'A0~3#port.interface.disparity.errors.count'=0;;;0; 'A0~3#port.interface.lost.dwords.count'=0;;;0; 'A0~3#port.interface.invalid.dwords.count'=0;;;0;
checking port 'A0'
    status: up [health: ok], read iops: 94.52, write iops: 161.11, read traffic: 1.29 Mb/s
    interface '0' disparity errors: 0, lost dwords: 0, invalid dwords: 0
    interface '1' disparity errors: 0, lost dwords: 0, invalid dwords: 0
    interface '2' disparity errors: 0, lost dwords: 0, invalid dwords: 0
    interface '3' disparity errors: 0, lost dwords: 0, invalid dwords: 0

Cette commande contrôle les statistiques des interfaces (--mode=interfaces).

La commande utilise l'api-username (--api-username='myapiusername'), l'api-password (--api-password='myapipassword') et elle se connecte à l'hôte 10.30.2.79 (--hostname='10.30.2.79') sur le port 443 (--port='443') utilisant le protocol https (--proto='https').

Pour chaque mode, la liste de toutes les métriques, seuils associés et options complémentaires peut être affichée en ajoutant le paramètre --help à la commande:

/usr/lib/centreon/plugins/centreon_dell_me4_restapi.pl \
    --plugin=storage::dell::me4::restapi::plugin \
    --mode=interfaces \
    --help

Diagnostique​

Diagnostique des plugins