Aller au contenu principal

HP StoreOnce 4.x Rest API

Contenu du Pack​

Modèles​

Le Pack Centreon HP StoreOnce apporte un modèle d'hôte :

  • HW-Storage-Hp-Storeonce4-Restapi-custom

Il apporte les modèles de service suivants :

AliasModèle de servicesDéfautDécouverte
AppliancesHW-Storage-Hp-Storeonce4-Appliances-RestapiXX
Hardware-StorageHW-Storage-Hp-Storeonce4-Hardware-Storage-RestapiX
StoresHW-Storage-Hp-Storeonce4-Stores-RestapiX

Règles de découverte​

Nom de la règleDescription
HW-Storage-Hp-Storeonce4-Restapi-Appliance-HostnameDécouvre les appliances et supervise l'utilisation
HW-Storage-Hp-Storeonce4-Restapi-Store-NameDécouvre les catalyst stores et supervise l'utilisation

Métriques & statuts collectés​

Metric nameDescriptionUnit
appliances.detected.countNumber of appliances detected
service statusCurrent appliance service status
appliance_hostname#appliance.disk.space.usage.bytesSpace used on the applianceB
appliance_hostname#appliance.disk.space.free.bytesFree space left on the appliance
appliance_hostname#appliance.disk.space.usage.percentageSpace used on the appliance in percentage%
appliance_hostname#appliance.deduplication.ratio.countDeduplication ratio on the appliance

Prérequis​

Ce Pack supporte uniquement les versions 4.x des équipements HP StoreOnce. Pour la supervision, un utilisateur avec les droits en lecture est nécessaire. Référez-vous à la documentation officielle : https://hewlettpackard.github.io/storeonce-rest/index.html

Installation​

  1. Installer le plugin Centreon sur tous les collecteurs Centreon devant superviser des ressources HP StoreOnce 4.x Rest API :
yum install centreon-plugin-Hardware-Storage-Hp-Storeonce4-Restapi
  1. Sur l'interface web de Centreon, installer le Pack HP StoreOnce 4.x Rest API depuis la page Configuration > Packs de plugins.

Configuration​

Hôte​

  • Ajoutez un hôte à Centreon depuis la page Configuration > Hôtes
  • Complétez les champs Nom, Alias & IP Address / DNS correspondant à votre serveur HP StoreOnce 4.x Rest API.
  • Appliquez le modèle d'hôte HW-Storage-Hp-Storeonce4-Restapi-custom.
  • Une fois le modèle appliqué, les macros ci-dessous indiquées comme requises (Obligatoire) doivent être renseignées.
ObligatoireNomDescription
XSTOREONCEAPIPORTPort used (Default: 443)
XSTOREONCEAPIPROTOSpecify http if needed (default: 'https')
XSTOREONCEAPIUSERNAMEApi username
XSTOREONCEAPIPASSWORDApi password
STOREONCEAPIEXTRAOPTIONSAny 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 votre collecteur Centreon en vous connectant avec l'utilisateur centreon-engine (su - centreon-engine) :

$CENTREONPLUGINS$/centreon_hp_storeonce4_restapi.pl \
    --plugin=storage::hp::storeonce::4::restapi::plugin \
    --mode=stores \
    --hostname='10.0.0.1' \
    --port='443' \
    --proto='https' \
    --api-username='my-username' \
    --api-password='my-password' \
    --verbose

La commande devrait retourner un message de sortie similaire à :

OK: All catalyst stores are ok | 'stores.detected.count'=3;;;0; 'Catalyst01#store.disk.space.usage.bytes'=1838969531121B;;;0; 'Catalyst01#store.user.space.usage.bytes'=62700600887099B;;;0; 'Catalyst01#store.deduplication.ratio.count'=34.00;;;0; 'Catalyst02#store.disk.space.usage.bytes'=50306416657426B;;;0; 'Catalyst02#store.user.space.usage.bytes'=1793362240355355B;;;0; 'Catalyst02#store.deduplication.ratio.count'=35.60;;;0; 'Catalyst03#store.disk.space.usage.bytes'=21192464324702B;;;0; 'Catalyst03#store.user.space.usage.bytes'=540818386772559B;;;0; 'Catalyst03#store.deduplication.ratio.count'=25.50;;;0;
checking catalyst store 'Catalyst01'
    health: ok
    disk space used: 1.67TB, user space used: 57.03TB
    deduplication ratio: 34.00
checking catalyst store 'Catalyst02'
    health: ok
    disk space used: 45.75TB, user space used: 1631.05TB
    deduplication ratio: 35.60
checking catalyst store 'Catalyst03'
    health: ok
    disk space used: 19.27TB, user space used: 491.87TB
    deduplication ratio: 25.50

La liste de toutes les options complémentaires et leur signification peut être affichée en ajoutant le paramètre --help à la commande:

$CENTREONPLUGINS$/centreon_hp_storeonce4_restapi.pl \
    --plugin=storage::hp::storeonce::4::restapi::plugin \
    --mode=stores \
    --help

Tous les modes disponibles peuvent être affichés en ajoutant le paramètre --list-mode à la commande:

$CENTREONPLUGINS$/centreon_hp_storeonce4_restapi.pl \
    --plugin=storage::hp::storeonce::4::restapi::plugin \
    --list-mode

Diagnostic des erreurs communes​

Rendez-vous sur la documentation dédiée des plugins basés sur HTTP/API.