# 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**.

[![pfms-first-steps-server_plugins-image-010.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/pfms-first-steps-server-plugins-image-010.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/pfms-first-steps-server-plugins-image-010.png)

<p class="callout info align-center"><span style="font-weight: normal;"><span style="font-size: 11pt; font-family: Arial; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; white-space: pre-wrap;">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`.</span></span></p>

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

[![pfms-first-steps-server_plugins-image-020.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/pfms-first-steps-server-plugins-image-020.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/pfms-first-steps-server-plugins-image-020.png)

Créez un module de type **Plugin module** :

[![pfms-first-steps-server_plugins-image-030.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/pfms-first-steps-server-plugins-image-030.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/pfms-first-steps-server-plugins-image-030.png)

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.

[![pfms-first-steps-server_plugins-image-040.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/pfms-first-steps-server-plugins-image-040.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/pfms-first-steps-server-plugins-image-040.png)

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 :

[![pfms-first-steps-server_plugins-image-060.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/pfms-first-steps-server-plugins-image-060.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/pfms-first-steps-server-plugins-image-060.png)

<p class="callout info">Selon le *plugin*, différents champs spécifiques devront être remplis, <span style="color: rgb(185, 106, 217);">par exemple</span>, 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 :</p>

![pfms-first-steps-server_plugins-image-050.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/pfms-first-steps-server-plugins-image-050.png)

#### *Plugins* d'Agent

##### GNU/Linux®

Ce type de *plugins* est stocké et exécuté depuis un EndPoint <span style="color: rgb(185, 106, 217);">et peut renvoyer plus d'une valeur</span>.

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.

[![pfms-first-steps-server_plugins-image-070.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/pfms-first-steps-server-plugins-image-070.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/pfms-first-steps-server-plugins-image-070.png)

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.

[![pfms-first-steps-server_plugins-image-080.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/pfms-first-steps-server-plugins-image-080.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/pfms-first-steps-server-plugins-image-080.png)

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.

[![pfms-first-steps-server_plugins-image-090.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/pfms-first-steps-server-plugins-image-090.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/pfms-first-steps-server-plugins-image-090.png)

##### 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.

[![plugin12.png](https://pandorafms.com/guides/public/uploads/images/gallery/2023-10/scaled-1680-/plugin12.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2023-10/plugin12.png)

<p class="callout info">Vous n'obtenez pas les résultats expliqués dans ce chapitre ? Accédez à la section d'[aide](https://pandorafms.com/guides/public/books/premiers-pas-avec-pandora-fms/page/21-ou-chercher-en-cas-de-probleme) ou de [support](https://pandorafms.com/guides/public/books/premiers-pas-avec-pandora-fms/page/22-assistance).</p>