Utiliser des Plugin Packs
Un Plugin Pack est un jeu téléchargeable de modèles de configuration qui permet un déploiement rapide de la supervision de votre infrastructure IT. Les Plugin Packs sont le moyen le plus simple de mettre un hôte en supervision.
Un Plugin Pack est constitué de deux éléments, installés séparément :
Un plugin, qui exécute les commandes de supervision depuis un collecteur. Il peut être installé en ligne de commande ou automatiquement.
Un pack, qui contient des commandes, des modèles de services et des modèles d’hôtes. Il est installé via l'interface de Centreon. Pour chaque type d’équipement, les modèles déterminent quels indicateurs seront supervisés et définissent les valeurs par défaut des seuils Warning et Critical (celles-ci sont modifiables par la suite).
Certains packs contiennent aussi des règles de découverte d'hôtes et de services.
La liste de tous les Plugin Packs disponibles dans la bibliothèque en ligne Centreon et les procédures de mise en supervision associées sont présentées dans la section Plugin Packs.
Prérequis
Centreon Plugin Pack Manager
Le module Centreon Plugin Pack Manager permet de gérer l’installation et la suppression des Plugin Packs. Il est installé par défaut. Il fait régulièrement l’objet de mises à jour, il est donc recommandé de rester à jour sur ce composant.
Pour mettre à jour le module, lancez la commande :
- Alma / RHEL / Oracle Linux 8
- CentOS 7
- Debian 11
dnf update centreon-pp-manager
yum update centreon-pp-manager
apt install --only-upgrade centreon-pp-manager
Licence
Une licence est nécessaire pour accéder au catalogue complet des Plugin Packs. Contactez les équipes support Centreon pour obtenir votre licence.
Connecteurs
Certains Plugin Packs nécessitent aussi un Connecteur (ex : AS400 ou VMware) ou un agent (ex : Windows NRPE). Dans ce cas, cela est indiqué dans la procédure de supervision du Plugin Pack. La licence des Plugin Packs inclut la licence des connecteurs.
Connecteur | Description |
---|---|
NRPE | Serveur NRPE packagé par Centreon avec les patchs nécessaires pour fonctionner avec les Plugin Packs |
NSClient++ | NSClient++ packagé par Centreon et prêt à l’emploi à l’aide de Centreon plugins embarqués |
VMWare | Démon Perl utilisant le SDK VMware pour contrôler les plateformes VMware |
AS400 | Connecteur basé sur Java permettant d’exécuter des contrôles sur AS400 |
Installer un Plugin Pack
Un plugin pack s'installe en 4 étapes :
- Accédez au catalogue des Plugin Packs.
- Installez le pack.
- Vérifiez la procédure de supervision.
- Installez le plugin.
Accéder au catalogue des Plugin Packs
- Si vous avez une licence en ligne, le catalogue des Plugin Packs est déjà disponible sur votre plateforme à la page Configuration > Packs de plugins.
- Si vous avez une licence hors ligne :
- installez le dépôt des Plugin Packs (rendez-vous sur le portail support Centreon pour en obtenir l'adresse)
- installez ou mettez à jour le catalogue des Plugin Packs depuis votre serveur central :
- Alma / RHEL / Oracle Linux 8
- CentOS 7
- Debian 11
dnf install centreon-pack-*
ou :
dnf update centreon-pack-*
yum install centreon-pack-*
ou :
yum update centreon-pack-*
apt install centreon-pack-*
ou :
apt install --only-upgrade centreon-pack-\*
Attention, même si la commande s'appelle
install
, elle ne fait que rendre le catalogue des Plugin Packs disponible. Elle n'installe pas ceux-ci. Suivez le reste de la procédure.
Installer le pack
Vous avez maintenant accès au catalogue des Plugin Packs, à la page Configuration > Packs de plugins :
Pour installer un pack, cliquez sur le +
Vous pouvez aussi cliquer sur le Plugin Pack. Vous accéderez à sa description et un bouton +
permettant
de l’installer.
Une fois le pack installé, il apparaîtra avec un contour vert et une coche indiquant qu’il est installé.
Avant installation | Après installation |
---|---|
Gestion des dépendances
Il se peut que durant l’installation, certains objets du pack ne soient pas installés. Ces objets sont souvent des objets de configuration additionnels et ne sont pas obligatoires pour déployer les modèles de configuration apportés par le pack.
La plupart du temps, il est nécessaire de mettre à jour votre plate-forme Centreon, puis de réinstaller votre pack.
Dans l’exemple ci-dessus, l’objet “autodiscover” concerne une règle de découverte pour le module “Centreon Auto Discovery”, mais celles-ci ne sont disponibles que pour Centreon en version 18.10.x :
Vérifier la procédure de supervision
Certains Plugin Packs demandent des étapes de configuration supplémentaires. Consultez la procédure de supervision associée à chaque pack installé pour comprendre le contenu du pack ainsi
que les prérequis nécessaires à son fonctionnement. Cliquez sur l'icône i
de chaque pack pour accéder à la documentation associée :
Installer le plugin
Installation automatique
- Installez le pack.
- Vérifiez dans la procédure de supervision si des étapes de configuration supplémentaires sont requises.
- À la page Configuration > Packs de plugins, réglez Installation automatique des plugins sur ON.
- Utilisez un modèle fourni par le pack pour mettre en supervision un hôte ou un service.
- Déployez la configuration des collecteurs qui superviseront cet hôte ou ce service : les plugins correspondants seront installés automatiquement sur ces collecteurs.
Installation manuelle
La procédure de supervision comprend une section Installation qui vous indique comment installer le plugin, que ce soit avec une licence en ligne ou une licence hors ligne. Installez le plugin sur tous les collecteurs qui exécuteront les contrôles.
La commande d'installation suit le modèle suivant :
- Alma / RHEL / Oracle Linux 8
- CentOS 7
- Debian 11
dnf install centreon-plugin-$PLUGIN-PACK$
dans laquelle $PLUGIN-PACK$
correspond au nom du pack. Exemple :
dnf install centreon-plugin-Cloud-Aws-Ec2-Api
yum install centreon-plugin-$PLUGIN-PACK$
dans laquelle $PLUGIN-PACK$
correspond au nom du pack. Exemple :
yum install centreon-plugin-Cloud-Aws-Ec2-Api
Attention, la commande
yum
est sensible à la casse.
apt install centreon-plugin-$PLUGIN-PACK$
dans laquelle $PLUGIN-PACK$
correspond au nom du pack. Exemple :
apt install centreon-plugin-cloud-aws-ec2-api
Utiliser un plugin pack
Appliquez un modèle issu d'un plugin pack à un hôte ou à un service pour mettre celui-ci en supervision :
Créez l'hôte/le service, et dans le champ Modèle(s), choisissez le modèle correspondant au plugin pack désiré.
Déployez la configuration.
Mettre à jour un Plugin Pack
Vous devez mettre à jour et le plugin et le pack.
Mettre à jour un ou plusieurs packs
Pour mettre à jour un pack :
Si vous constatez une icône représentant une flèche sur un Plugin Pack, cela veut dire qu’une mise à jour du pack est disponible.
Pour le mettre à jour, cliquez sur la flèche,
ou cliquez sur le Plugin Pack. Une fenêtre affiche alors des informations relatives au Plugin Pack, avec une icône flèche permettant de le mettre à jour. Cliquez sur la flèche pour lancer la mise à jour :
Confirmez la mise à jour.
Votre pack est maintenant à jour. Vous pouvez maintenant mettre à jour les plugins.
Pour mettre à jour tous les packs :
Vous pouvez également mettre à jour tous les packs en une seule fois : lorsque des mises à jour de packs sont disponibles, un bouton Tout mettre à jour apparaît. Attention, vous devrez quand même mettre à jour les plugins.
Mettre à jour les plugins
À la page Configuration > Packs de plugins, si Installation automatique des plugins est à ON, les plugins seront mis à jour automatiquement lorsque vous déploierez la configuration d'un collecteur qui supervise un hôte ou un service qui utilise ce plugin.
Si Installation automatique des plugins est à OFF, utilisez la commande suivante pour mettre à jour les plugins :
- Exécutez la commande suivante sur tous les collecteurs:
- Alma / RHEL / Oracle Linux 8
- CentOS 7
- Debian 11
dnf update centreon-plugin\*
yum update centreon-plugin\*
apt-get --only-upgrade install centreon-plugin\*
Déployez la configuration sur tous les collecteurs. L'option Redémarrer l'ordonnanceur doit avoir la valeur Redémarrer.
Vérifiez qu’il n’y a pas de nouvelles erreurs suite à l’exécution des nouvelles sondes.
C’est à vous de choisir si vous désirez installer les plugins sur tous les pollers, ou seulement sur le poller qui exécutera les contrôles. Gardez en tête que si vous n’installez par le plugin sur un poller, vous pourriez avoir des erreurs si vous décidez un jour de déplacer un hôte supervisé d’un poller avec le plugin vers un poller ne possédant pas le plugin. Par ailleurs, si vous mettez à jour les packs sur le serveur central, il est fortement recommandé de mettre à jour également les plugins associés sur les pollers, car de nouveaux contrôles sont parfois définis dans les packs, et ne fonctionneront pas s’ils n’ont pas la commande correspondante.
Désinstaller un Plugin Pack
Comme pour l’installation, la désinstallation du pack peut se faire soit en survolant le pack souhaité puis en cliquant sur la croix rouge :
Ou alors en cliquant sur le pack, s’ouvre un pop-up affichant le nom, la version et la description du pack, ainsi qu’une croix permettant la désinstallation :
Confirmez la désinstallation.
Votre Plugin Pack est désinstallé.
Gestion des dépendances
Si les modèles d’hôtes et de services créés par le Plugin Pack sont utilisés par des hôtes et services actifs, le Plugin Pack ne pourra être désinstallé.
Pour pouvoir le désinstaller, soit vous :
- supprimez les hôtes ou services liés aux modèles fournis par ce Plugin Pack
- déliez les hôtes ou services liés aux modèles fournis par ce Plugin Pack
De plus, si vous tentez de désinstaller un pack dépendant d’un autre pack, la désinstallation ne pourra être faite que si et seulement si ce pack n’est pas utilisé ni le(s) pack(s) dépendant(s). De plus, les packs dépendant seront également supprimés.