Ericsson ENM API
Contenu du Pack​
Objets supervisés​
Le Pack Ericsson ENM collecte les données pour:
- Nodes
Règles de découvertes​
- Hosts
- Services
Le Pack Centreon Ericsson ENM API inclut un provider de découverte d'Hôtes. Celui-ci permet de découvrir l'ensemble des noeuds rattachés à un Ericsson Network Manager.
Vous trouverez plus d'informations sur la découverte d'Hôtes et son fonctionnement sur la documentation du module: Découverte des hôtes
| Nom de la règle | Description |
|---|---|
| App-Ericsson-Enm-Api-Node-Celltdd-Id | Découvre les cells tdd et supervise leur statut |
| App-Ericsson-Enm-Api-Node-Fru-Id | Découvre les unités remplaçables et supervise leur statut |
| App-Ericsson-Enm-Api-Node-Id | Découvre les noeuds et supervise ses composants (fru, cells) |
Métriques collectées​
- Nodes
| Metric name | Description | Unit |
|---|---|---|
| nodes.total.count | Number of nodes | |
| node synchronization status | Current synchronization status of the node | |
| fru status | Current status of the field replaceable unit | |
| cell tdd status | Current status of the cell tdd |
Prérequis​
Afin de contrôler votre Ericsson Network Manager, l'API Rest doit être configurée. Le Pack ne supporte que l'authentification par utilisateur et mot de passe.
Installation​
- Online License
- Offline License
- Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Applications-Ericsson-Enm-Api
- Sur l'interface Web de Centreon, installer le Pack Ericsson ENM API depuis la page Configuration > Gestionnaire de connecteurs de supervision
- Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Applications-Ericsson-Enm-Api
- Sur le serveur Central Centreon, installer le Pack via le RPM:
yum install centreon-pack-applications-ericsson-enm-api
- Sur l'interface Web de Centreon, installer le Pack Ericsson ENM API depuis la page Configuration > Gestionnaire de connecteurs de supervision
Configuration​
Ce Pack est conçu de manière à avoir dans Centreon un hôte par Ericsson Network Manager. Lorsque vous ajoutez un hôte à Centreon, appliquez-lui le modèle App-Ericsson-Enm-Api-custom. Une fois celui-ci configuré, certaines macros doivent être renseignées:
| Mandatory | Name | Description |
|---|---|---|
| X | ERICSSONENMAPIPORT | Port used (Default: 443) |
| X | ERICSSONENMAPIPROTO | Specify https if needed (Default: 'https') |
| X | ERICSSONENMAPIUSERNAME | Api username |
| X | ERICSSONENMAPIPASSWORD | Api password |
| ERICSSONENMEXTRAOPTIONS | 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_ericsson_enm_api.pl \
--plugin=apps::ericsson::enm::api::plugin \
--mode=nodes \
--hostname='10.30.2.79' \
--port='443' \
--proto='https' \
--http-backend='curl' \
--insecure \
--api-username='myapiusername' \
--api-password='myapipassword' \
--filter-node-id='ORA01200E_02' \
--verbose
La commande devrait retourner un message de sortie de la forme ci-dessous:
OK: Node 'ORA01200E_02' synchronization status: synchronized - All field replaceable units are ok - All tdd cells are ok | 'nodes.total.count'=1;;;0;
checking node 'ORA01200E_02'
synchronization status: synchronized
field replaceable unit 'BB-1' [label: ORA01200E_02] operational state: enabled, admin state: unlocked
field replaceable unit 'RRU-1' [label: RRU-1_ORA4043_11] operational state: enabled, admin state: unlocked
field replaceable unit 'RRU-10' [label: RRU-10_ORA4010_11] operational state: disabled, admin state: unlocked, availability status: [dependency_locked, dependency]
field replaceable unit 'RRU-11' [label: RRU-11_ORA4019_11] operational state: disabled, admin state: unlocked, availability status: [dependency_locked, dependency]
field replaceable unit 'RRU-12' [label: RRU-12_ORA4024_11_12] operational state: disabled, admin state: unlocked, availability status: [dependency_locked, dependency]
field replaceable unit 'RRU-13' operational state: disabled, admin state: unlocked, availability status: [dependency_locked, dependency]
field replaceable unit 'RRU-14' operational state: disabled, admin state: unlocked, availability status: [dependency_locked, dependency]
field replaceable unit 'RRU-15' operational state: disabled, admin state: unlocked, availability status: [dependency_locked, dependency]
field replaceable unit 'RRU-2' [label: RRU-2_ORA4045_11_12] operational state: enabled, admin state: unlocked
field replaceable unit 'RRU-3' [label: RRU-3_ORA4047_11_12] operational state: enabled, admin state: unlocked
field replaceable unit 'RRU-4' [label: RRU-4_ORA4049_11] operational state: enabled, admin state: unlocked
field replaceable unit 'RRU-5' [label: RRU-5_ORA4056_11] operational state: enabled, admin state: unlocked
field replaceable unit 'RRU-6' [label: RRU-6_ORA4054_11_12] operational state: enabled, admin state: unlocked
field replaceable unit 'RRU-7' [label: RRU-7_ORA4052_11_12] operational state: enabled, admin state: unlocked
field replaceable unit 'RRU-8' [label: RRU-8_ORA4050_11] operational state: enabled, admin state: unlocked
field replaceable unit 'RRU-9' [label: RRU-9_ORA4005_11_12] operational state: disabled, admin state: unlocked, availability status: [dependency_locked, dependency]
tdd cell 'ORA4005_11' [label: ORA-Metro-S31A_85] operational state: disabled, admin state: locked, availability status: [off_line]
tdd cell 'ORA4005_12' [label: ORA-Metro-S31B_85] operational state: disabled, admin state: locked, availability status: [off_line]
tdd cell 'ORA4010_11' [label: ORA-Metro-S36_265] operational state: disabled, admin state: locked, availability status: [off_line]
tdd cell 'ORA4019_11' [label: ORA-Metro-S41_85] operational state: disabled, admin state: locked, availability status: [off_line]
tdd cell 'ORA4024_11' [label: ORA-Metro-S46A_265] operational state: disabled, admin state: locked, availability status: [off_line]
tdd cell 'ORA4024_12' [label: ORA-Metro-S46B_265] operational state: disabled, admin state: locked, availability status: [off_line]
tdd cell 'ORA4043_11' [label: ORA-Metro-T2F04_245] operational state: enabled, admin state: unlocked
tdd cell 'ORA4045_11' [label: ORA-Metro-T2F16_325] operational state: enabled, admin state: unlocked
tdd cell 'ORA4045_12' [label: ORA-Metro-T2F16-RDS_140] operational state: enabled, admin state: unlocked
tdd cell 'ORA4047_11' [label: ORA-Metro-T2F28_10] operational state: enabled, admin state: unlocked
tdd cell 'ORA4047_12' [label: ORA-Metro-T2F28-RDS_195] operational state: enabled, admin state: unlocked
tdd cell 'ORA4049_11' [label: ORA-Metro-T2F34_80] operational state: enabled, admin state: unlocked
tdd cell 'ORA4050_11' [label: ORA-Metro-T2F94_100] operational state: enabled, admin state: unlocked
tdd cell 'ORA4052_11' [label: ORA-Metro-T2F90_65] operational state: enabled, admin state: unlocked
tdd cell 'ORA4052_12' [label: ORA-Metro-T2F90-RDS_215] operational state: enabled, admin state: unlocked
tdd cell 'ORA4054_11' [label: ORA-Metro-T2F80_0] operational state: enabled, admin state: unlocked
tdd cell 'ORA4054_12' [label: ORA-Metro-T2F80-RDS_150] operational state: enabled, admin state: unlocked
tdd cell 'ORA4056_11' [label: ORA-Metro-T2F68_270] operational state: enabled, admin state: unlocked
Cette commande contrôle les noeuds (--mode=nodes).
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 peuvent être affichés
en ajoutant le paramètre --help à la commande:
/usr/lib/centreon/plugins/centreon_ericsson_enm_api.pl \
--plugin=apps::ericsson::enm::api::plugin \
--mode=nodes \
--help