Aller au contenu principal

Netapp Santricity Restapi

Vue d'ensemble​

Le système d'exploitation SANtricity, délivré par l'entreprise NetApp, accélère et fiabilise vos données de stockage tout en renforçant la protection de celles-ci. Le service SANtricity Web Services Proxy (WSP) permet d'accéder de manière normalisée à la configuration et aux indicateurs des équipements NetApp par l'utilisation d'une API Rest HTTP.

Contenu du connecteur de supervision​

Éléments supervisés​

Le connecteur de supervision SANtricity permet de superviser les ressources NetApp accessibles au travers de l'API SANtricity:

  • Contrôleurs
  • Volumes

Métriques collectées​

Les métriques collectées sont les suivantes:

Metric nameDescription
statusCheck components operational status: battery, cbd, ctrl, drive, fan, psu, storage, thsensor. Unit: count
hardware.drive.temperature.celsiusCheck drives temperature. Unit: °C

Prérequis​

Configuration de l'API SANtricity​

Le Plugin Centreon Netapp Santricity Restapi s'appuie sur l'API Rest NetApp SANtricity fournie par la solution Web Services Proxy (WSP). Celle-ci doit être préalablement installée et opérationnelle sur un serveur dédié (Windows/Linux) afin de pouvoir utiliser l'API Rest. Les ressources ci-après décrivent les méthodes d'installation ainsi que le fonctionnement de l'API.

Ressources en ligne​

Installation​

  1. Installer le Plugin sur tous les collecteurs Centreon supervisant des ressources Netapp SANtricity:
yum install centreon-plugin-Hardware-Storage-Netapp-Santricity-Restapi
  1. Depuis l'interface Web de Centreon, installer le connecteur de supervision Netapp Santricity Restapi depuis la page Configuration > Connecteurs > Connecteurs de supervision

Configuration​

  • Depuis l'interface Web de Centreon, ajoutez un nouvel Hôte depuis la page "Configuration > Hôtes".
  • Appliquez le modèle d'Hôte "HW-Storage-Netapp-Santricity-Restapi-custom" et configurer les macros nécessaires :
MandatoryNameDescription
XAPIPORTPort used (Default: 8080)
XAPIUSERNAMESantricity API username.
XAPIPASSWORDSantricity API password. Password checkbox must be checked
XAPIPATHSpecify api path (Default: '/devmgr/v2')
XAPIPROTOSpecify https if needed (Default: 'http')
APIEXTRAOPTIONSAny extra option you may want to add to the command (eg. a --verbose flag)

FAQ​

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 votre collecteur Centreon avec l'utilisateur centreon-engine:

/usr/lib/centreon/plugins/centreon_netapp_santricity_restapi.pl \
    --plugin=storage::netapp::santricity::restapi::plugin \
    --hostname=sancitricy.int.centreon.com \
    --port=8080 \
    --proto=http \
    --api-path='/devmgr/v2' \
    --api-username='admin' \
    --api-password='xxxx' \
    --mode=storage-volumes \
    --verbose \
    --warning-volume-status='%\{status\} =~ /degraded/i' \
    --critical-volume-status='%\{status\} =~ /failed/i'

La commande doit retourner un résultat de la forme:

OK: storage system 'SAN-XXX' volumes are ok |
checking storage system 'SAN-XXXX'
    volume 'Datastore_X' status: optimal
    volume 'Datastore_Y' status: optimal

Cette commande vérifie le statut des volumes NetApp (--mode=storage-volumes) en requêtant l'API SANtricity du serveur santricity.int.centreon.com (--hostname=sancitricy.int.centreon.com). L'authentification à l'API s'effectue avec un utilisateur admin (--api-user=admin) et un mot de passe xxxx associé (api-password='xxxx').

Cette commande déclenchera une alarme WARNING si l'un des volumes est en statut degraded (--warning-volume-status='%{status} =~ /degraded/i') et une alarme de type CRITICAL pour un statut failed (--critical-volume-status='%{status} =~ /failed/i').

Pour chaque mode, les options disponibles peuvent être consultées en ajoutant l'option --help à la commande:

/usr/lib/centreon/plugins/centreon_netapp_santricity_restapi.pl \
    --plugin=storage::netapp::santricity::restapi::plugin \
    --mode=storage-volumes \
	  --help

J'obtiens le message d'erreur suivant:​

UNKNOWN: 500 Can't connect to santricity.int.centreon.com:8080 |​

Lors du déploiement de mes contrôles, j'obtiens le message suivant: UNKNOWN: 500 Can't connect to santricity.int.centreon.com:8080 |.

Cela signifie que Centreon n'a pas réussi à se connecter à l'API Netapp SANtricity.

Si l'utilisation d'un proxy est requise pour les connexions HTTP depuis le collecteur Centreon, il est nécessaire de le préciser dans la commande en utilisant l'option --proxyurl='http://proxy.mycompany:8080'.

UNKNOWN: 501 Protocol scheme 'connect' is not supported |​

Suite à la mise en place du proxy, j'obtiens le message suivant UNKNOWN: 501 Protocol scheme 'connect' is not supported |

Cela signifie que le protocole de connexion au proxy n'est pas supporté par la libraire lwp utlisée par défaut par le Plugin Centreon.

Cette erreur peut être résolue en utilisant le backend HTTP curl. Pour ce faire, ajoutez l'option --http-backend='curl' à la commande.

UNKNOWN: Cannot load module 'Net::Curl::Easy'​

Ce message d'erreur signifie qu'une librairie Perl est manquante.

Dans le cas présent, vous pouvez installer la librairie manquante en lançant la commande suivante:

yum install perl-Net-Curl