Un plugin (complément) distant est un script ou un exécutable qui prend en charge des paramètres et renvoie une valeur.
Pour enregistrer un plugin dans Pandora FMS, allez dans la section d’administration de la console, et dans celle-ci cliquez sur Serveurs ; puis cliquez sur Plugins, puis cliquez sur le bouton Add.
Une nouvelle page sera ouverte avec un formulaire, où nous devrons remplir les champs pour l’exécution de notre plugin :
- Name: Nom du plugin.
- Plugin type: Il existe deux types de plugins, standard et de type Nagios. Les plugins standard sont des scripts qui exécutent des actions et prennent en charge des paramètres. Les plugins Nagios sont, comme leur nom l’indique, des plugins Nagios qui peuvent être utilisés dans Pandora FMS. La différence réside principalement dans le fait que les plugins Nagios renvoient un niveau d’erreur pour indiquer si le test a réussi ou non et une chaîne descriptive supplémentaire. Cette description n’est pas une valeur numérique qui pourrait être utilisée comme valeur de module, donc dans ce cas nous l’utiliserons pour mettre à jour la description du module.
- Max. timeout: C’est le délai d’expiration du complément. Si aucune réponse n’est reçue dans ce délai, l’exécution sera arrêtée. C’est un élément très pertinent lorsque l’on met en œuvre la surveillance avec des plugins, car si le temps nécessaire à l’exécution du plugin est supérieur à ce nombre, nous ne pourrons jamais obtenir de valeurs avec lui (il ne sera même pas initialisé). Cette valeur doit toujours être supérieure au temps que prend normalement le script/exécutable utilisé comme plugin pour renvoyer une valeur.
- Description: Description du complément.
- Plug-in command: Chemin d’accès à l’exécutable du plugin. Par défaut, si l’installation a été standard, ils se trouveront dans le répertoire
/usr/share/pandora_server/util/plugin/. Bien qu’il puisse s’agir de n’importe quelle voie dans le système. Dans ce cas, écrivez:
/usr/share/pandora_server/util/plugin/udp_nmap_plugin.sh
- Plug-in parameters: Une chaîne de caractères avec les paramètres du plugin, qui ira après la commande et un espace vide. Ce champ accepte des macros telles que
_field1__field2_._fieldN_. C’est là que se trouve la partie la plus complexe du fonctionnement d’un plugin. Ne paniquez pas, nous le verrons avec un exemple. - Parameters macros: Il est possible d’ajouter un nombre illimité de macros à utiliser dans le champ de paramètres du plugin. Ces macros apparaîtront sous la forme de champs de texte dans la configuration du module pour que l’utilisateur puisse s’abstraire de la complexité de l’utilisation d’un module de type plugin. L’idée est que l’utilisateur utilise un plugin comme s’il s’agissait d’un module “bibliothèque” où il remplit des champs, sans avoir à savoir comment il fonctionne en dessous. La macro définition permet à l’utilisateur de remplir les paramètres d’appel de script sans savoir comment cela fonctionne, ni le script ni la façon de l’appeler.
- Description: Une courte chaîne décrivant la macro. Ce sera l’étiquette qui apparaîtra à côté du champ sur le formulaire.
- Valeur par défaut: Valeur attribuée au champ par défaut.
- Aide: Un texte explicatif de la macro, pour montrer un exemple d’utilisation ou pour mieux expliquer à quoi sert le champ.
Pour plus d’informations, voici le lien vers notre wiki :