Oracle ZS Rest API
Contenu du Pack​
Objets supervisés​
Le Pack Oracle ZS collecte les données pour:
- Hardware
- Pools
Métriques collectées​
- Hardware
- Pools
| Metric name | Description | Unit |
|---|---|---|
| chassis status | Chassis state | |
| cpu status | CPU state | |
| disk status | Disk state | |
| fan status | Fan state | |
| memory status | Memory state | |
| power supply status | Power supply state | |
| slot status | Slot state |
| Metric name | Description | Unit |
|---|---|---|
| pool status | Pool status | |
| pool_name#pool.space.usage.bytes | Space usage | B |
| pool_name#pool.space.free.bytes | Free space | B |
| pool_name#pool.space.usage.percentage | Space usage in percentage | % |
Prérequis​
Afin de contrôler votre équipement Oracle ZS, l'API Rest doit être configurée (cf: https://docs.oracle.com/cd/E79446_01/html/E79460/index).
Installation​
- Online License
- Offline License
- Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Hardware-Storage-Oracle-Zs-Restapi
- Sur l'interface Web de Centreon, installer le Pack Oracle ZS Rest API depuis la page Configuration > Connecteurs > Connecteurs de supervision
- Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Hardware-Storage-Oracle-Zs-Restapi
- Sur le serveur Central Centreon, installer le Pack via le RPM:
yum install centreon-pack-hardware-storage-oracle-zs-restapi
- Sur l'interface Web de Centreon, installer le Pack Oracle ZS Rest API depuis la page Configuration > Connecteurs > Connecteurs de supervision
Configuration​
Ce Pack est conçu de manière à avoir dans Centreon un hôte par équipement Oracle ZS. Lorsque vous ajoutez un hôte à Centreon, appliquez-lui le modèle HW-Storage-Oracle-Zs-Restapi-custom. Une fois celui-ci configuré, certaines macros doivent être renseignées:
| Mandatory | Name | Description |
|---|---|---|
| X | APIPORT | Port used (Default: 215) |
| X | APIPROTO | Specify https if needed (Default: 'https') |
| X | APIUSERNAME | Api username |
| X | APIPASSWORD | Api password |
| APIEXTRAOPTIONS | Any 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_oracle_zs_restapi.pl \
--plugin=storage::oracle::zs::restapi::plugin \
--mode=pools \
--hostname='10.30.2.79' \
--port='215' \
--proto='https' \
--api-username='myapiusername' \
--api-password='myapipassword' \
--verbose
La commande devrait retourner un message de sortie de la forme ci-dessous:
OK: All pools are ok | 'Pool_Exalogic#pool.space.usage.bytes'=19730301416448B;;;0;33432025432064 'Pool_Exalogic#pool.space.free.bytes'=13176557201408B;;;0;33432025432064 'Pool_Exalogic#pool.space.usage.percentage'=59.02%;;;0;100
Pool 'Pool_Exadata' status : exported
Pool 'Pool_Exalogic' status : online, space usage total: 30.41 TB used: 17.94 TB (59.02%) free: 11.98 TB (39.41%)
Cette commande contrôle les pools (--mode=pools).
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 215 (--port='215') utilisant le protocol https (--proto='https').
Pour chaque mode, la liste de toutes les métriques, seuils associés et options complémentaires peuvent être affichés
en ajoutant le paramètre --help à la commande:
/usr/lib/centreon/plugins/centreon_oracle_zs_restapi.pl \
--plugin=storage::oracle::zs::restapi::plugin \
--mode=pools \
--help