Aller au contenu principal

Ericsson ENM API

Contenu du Pack

Objets supervisés

Le Pack Ericsson ENM collecte les données pour:

  • Nodes

Règles de découvertes

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

Métriques collectées

Metric nameDescriptionUnit
nodes.total.countNumber of nodes
node synchronization statusCurrent synchronization status of the node
fru statusCurrent status of the field replaceable unit
cell tdd statusCurrent 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

  1. Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Applications-Ericsson-Enm-Api
  1. Sur l'interface Web de Centreon, installer le Pack Ericsson ENM API depuis la page Configuration > Plugin Packs > Gestionnaire

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:

MandatoryNameDescription
XERICSSONENMAPIPORTPort used (Default: 443)
XERICSSONENMAPIPROTOSpecify https if needed (Default: 'https')
XERICSSONENMAPIUSERNAMEApi username
XERICSSONENMAPIPASSWORDApi password
ERICSSONENMEXTRAOPTIONSAny 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

Diagnostique

Diagnostique des plugins