Si vous avez optez pour la solution ESIA Infinity, vous pouvez développer vos propres plugins et les ajouter dans Esia !

Le plugin doit être un fichier qui peut être exécuté par le serveur. Il peut donc être codé en PHP, Perl, Python, … Et utilisé des librairies indépendantes pour ces languages. À condition que ces languages et librairies soient installés sur le serveur.

Le plugin doit toujours renvoyer un des status suivants sous forme numérique :

Le résultat du stdout du plugin sera affiché dans l'interface ⇒ État des services.

Exemple pour le plugin check_icmp.

En ligne de commande sur le serveur esia :

copy

/usr/local/esia/plugins# ./check_icmp -H 10.5.0.1 -w 200,50% -c 500,100%

Aura pour résultat :

OK - 10.5.0.1: rta 1.837ms, lost 0%

Affichera dans l'interface web :

Pour créer un stdout, en PHP par exemple, il suffit de faire un :

copy

echo "mon message de sortie";

Ne pas oublier de renvoyer le status sous forme numérique :

copy

exit(0);

Allez voir comment les autres plugins sont construits !

Sur votre serveur Esia dans le répertoire /usr/local/esia/plugins/

Dans Esia, les noms des plugins sont toujours en lettres capitales et les mots séparés par des underscores. Veillez à donner des noms clairs et explicites à vos plugins de manière à savoir ce qu'ils font rien qu'en lisant leur nom.

Respectez le canevas suivant : <type de plugin>_<protocole>_<plateforme>_<élément testé>

Exemples :

GESA_SNMP_WINDOWS_STORAGE

• GESA : Teste via le boitier Unity.
• SNMP : utilise le protocole SNMP.
• WINDOWS : pour tous les OS Windows.
• STORAGE : teste l'espace de stockage utilisé sur un lecteur.

CHECK_HTTPS

• CHECK : Teste directement depuis le serveur
• HTTPS : si un serveur HTTPS est présent

Il est important que vous respectiez ces règles quand vous ajoutez un nouveau plugin pour garder un ensemble cohérent.

D'abord, copiez l'exécutable de votre plugin sur le serveur Esia dans le répertoire /usr/local/esia/plugins/ (Vérifiez que le fichier a les droits d'exécution X)

Sur l'interface web, rendez-vous dans le menu « Administration  ». Allez dans « Plugins » puis cliquez sur l'icône en haut à droite.

Cela vous ouvrira une nouvelle fenêtre.

Configurez le nouveau plugin :

• Nom du plugin : Le nom qu'il aura dans l'interface. (Veillez à respecter la Nomenclature des plugins)

• Chemin d'accès : Le chemin et le nom du fichier exécutable depuis le répertoire sur le serveur /usr/local/esia/plugins/ (Vérifiez que le fichier a les droits d'exécution X).

  Exemple : sur l'image ci-dessus notre exécutable check_snmp_load.pl se situe à la racine du répertoire /usr/local/esia/plugins/

• Type : Cette option sera implémentée dans le futur.

• OID de la trap SNMP : Cette option sera implémentée dans le futur.

• Paramètres* : Ici vous pouvez configurer les options par défaut à passer au plugin.

• Intervalle* : Temps par défaut entre les exécutions du plugin en millisecondes (300 = 5 minutes).

• Priorité* : Choisissez une priorité par défaut pour le test (Voir Ajouter des services => Priorité des services).

• Description : Que fait ce plugin.

* : Paramètres, Intervalle et Priorité sont des valeurs par défaut. Elles pourront être modifiées au cas par cas sur chaque nœud si nécessaire.

N'oubliez pas de cliquer sur « Ajouter » en bas à gauche pour sauvegarder le plugin.