12. Comment utiliser les plugins Pandora FMS

Les plugins permettent à Pandora FMS d'obtenir des informations nécessitant un traitement complexe ou l'utilisation de systèmes ou d'API complexes. Des exemples de plugins peuvent être : la surveillance de bases de données MySQL® ou la perte de paquets entre appareils.

Ce guide rapide présente des exemples de plugins inclus par défaut dans Pandora FMS. Il existe également la possibilité de créer nos propres plugins de serveur et d'EndPoint.

Plugins de Serveur

Pandora FMS inclut par défaut quelques plugins prêts à être utilisés. Pour visualiser les plugins de serveur enregistrés dans Pandora FMS, rendez-vous dans Management → Servers → Plugins. Ce type de plugins ne renvoie qu'une seule valeur.

Ces plugins sont stockés dans le répertoire /usr/share/pandora_server/util/plugin/ et sont exécutés par le PFMS Server.

Pour utiliser ce type de plugins, il est nécessaire que le serveur de plugins soit activé dans le fichier /etc/pandora/pandora_server.conf sous le token heavyserver 1.

Pour créer un module distant de type plugin, accédez à l'édition de l'agent, dans l'onglet Modules :

Créez un module de type Plugin module :

Il se configure généralement de la même manière que tout autre type de module distant. Dans ce type de module, nous disposons du menu déroulant Plugin, qui nous permet de choisir le plugin à utiliser.

Dans cet exemple, le plugin Packet Loss est utilisé pour vérifier la quantité de paquets perdus sur un intervalle de temps entre le serveur et la destination.

Remplissez les champs avec les informations nécessaires ; dans le cas du plugin Packet Loss, définissez le temps de test et l'adresse IP de destination.

Quelques secondes après la création du module, celui-ci apparaîtra dans la vue de l'agent avec sa valeur obtenue :

Selon le plugin, différents champs spécifiques devront être remplis, par exemple, pour le plugin MySQL, il faut définir l'adresse IP du serveur MySQL, le nom d'utilisateur et le mot de passe, ainsi que la donnée que nous souhaitons extraire :

Plugins d'Agent

GNU/Linux®

Ce type de plugins est stocké et exécuté depuis un EndPoint et peut renvoyer plus d'une valeur.

Ces plugins sont stockés dans le répertoire /usr/share/pandora_agent/plugins/ de l'agent local et sont définis dans le fichier de configuration /etc/pandora/pandora_agent.conf.

Dans le fichier de configuration, certains plugins d'agent sont définis par défaut. Dans cet exemple, on utilise un plugin nommé top.sh, qui affiche les processus en cours d'exécution sur l'agent.

Pour voir le module créé et sa valeur (ou ses valeurs, selon le plugin), rendez-vous dans la vue Agent (de l'EndPoint) de la console Web.

On remarque que la donnée obtenue est représentée par une icône en forme de feuille de papier. Cliquez sur cette icône pour afficher la liste des processus extraits de l'équipement via le plugin d'agent.

MS Windows®

Les plugins sont stockés dans le répertoire %ProgramFiles%\pandora_agent\util\ et sont définis dans le fichier de configuration %ProgramFiles%\pandora_agent\pandora_agent.conf.

Comme sous Linux®, quelques exemples de plugins sont définis dans le fichier de configuration.

Vous n'obtenez pas les résultats expliqués dans ce chapitre ? Accédez à la section d'aide ou de support.