12. Comment utiliser les plugins Pandora FMS
Les plugins permettent à Pandora FMS d'obtenir des informations qui nécessitent un traitement complexe ou qui requièrent l'utilisation de systèmes ou d'API complexes. Exemples de plugins : Supervision de la base de données MySQL.
Dans ce guide rapide, nous montrerons des exemples de plugins qui sont inclus par défaut dans Pandora FMS, mais il est possible de créer vos propres plugins de serveur et d'agent.
Server Plugins
Pandora FMS inclut par défaut quelques plugins prêts à être utilisés. Pour visualiser les plugins du serveur enregistré dans Pandora FMS allez 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 serveur.
Pour utiliser ce type de plugins, il est nécessaire que le serveur de plugins soit activé dans le fichier plugins /etc/pandora/pandora_server.conf.
Pour créer un module distant de type plugin, accédez à l'édition de l'agent, à l'onglet Modules :
Nous créons un module serveur de plugins.
En général, il est configuré de la même manière que tout autre type de module distant, dans ce type de module il se trouve le menu déroulant Plugin, qui vous permet de choisir le plugin à utiliser.
Dans cet exemple, le plugin Packet Loss est utilisé pour vérifier le nombre de paquets perdus dans un laps de temps entre le serveur et la destination.
Nous remplissons 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.
Voici à quoi ressemble le module configuré :
En fonction du plugin, vous devrez remplir différents champs spécifiques, par exemple, pour le plugin MySQL, vous devez définir l'adresse IP du serveur MySQL, le nom d'utilisateur et le mot de passe, ainsi que les données que vous souhaitez extraire.
Quelques secondes après avoir créé le module, le module et sa valeur obtenue apparaissent dans la vue de l'agent :
Agent Plugins
GNU/Linux
Ce type de plugins est stocké et exécuté à partir d'un agent logiciel et peut renvoyer plusieurs valeurs.
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 sont définis par défaut certains agents plugins dans cet exemple est utilisé un plugin appelé top.sh, qui montre les processus qui sont en cours d'exécution dans l'agent.
Pour voir le module créé et sa valeur (ou ses valeurs, selon le plugin), allez dans la vue de l'agent logiciel dans la console Web.
Nous observons qu'une icône en forme de feuille de papier est affichée comme données obtenues, cliquez sur cette icône pour afficher la liste des processus extraits de l'équipement par le plugin de l'agent.
MS Windows
Les plugins sont stockés dans le répertoire %ProgramFiles%\pandora_agent_agent.conf et sont définis dans le fichier de configuration %ProgramFiles%\pandora_agent_agent.conf.
De même que sous GNU/Linux, quelques exemples de plugins sont définis dans le fichier de configuration.
Vous n'atteignez pas les résultats attendus pour ce chapitre ? Accédez à la section d'aide ou soutien.