Account Tools

Search Tools

How to create a plugin (Only for ESIA Infinity)

If you have chosen the ESIA Infinity solution, you can develop your own plugins and add them to Esia!



The plugin must be a file that can be executed by the server. It can therefore be coded in PHP, Perl, Python, … And use independent libraries for these languages. Provided that these languages and libraries are installed on the server.

The plugin must always return one of the following statuses in numerical form :

Service status Numeric value
OK 0
Warning 1
Critical 2
Unknown 3

Output message

The result of the stdout of the plugin will be displayed in the ⇒ Service status interface.

Example for the check_icmp plugin.

On the command line on the esia server:

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

The result will be :

OK - rta 1.837ms, lost 0%

Will display in the web interface :

 Output result of the plugin in the interface

To create a stdout, in PHP for example, you just need to do a :

echo "mon message de sortie";

Don't forget to return the status in numerical form:


Check out how the other plugins are built!

On your Esia server in the directory /usr/local/esia/plugins/

Plugin nomenclature

In Esia, the names of plugins are always in capital letters and the words separated by underscores. Make sure you give your plugins clear, explicit names so that you know what they do just by reading their name.

Use the following format: <type de plugin>_<protocole>_<plateforme>_<élément testé>

Plugin type Description
GESA For plugins that go through a Unity to find the information they are looking for (ESIA Unity)
CHECK For plugins that directly query a node (mainly ESIA Infinity).
TRAP For plugins that use SNMP Trap.
MAN For Management plugins.
CORR For correlation plugins. These are plugins that work on the results of other plugins.



  • GESA: Tests via the Unity box.
  • SNMP: uses the SNMP protocol.
  • WINDOWS: for all Windows OS.
  • STORAGE: tests the storage space used on a drive.


  • CHECK: Tests directly from the server.
  • HTTPS: if an HTTPS server is present

It's important that you follow these rules when you add a new plugin to keep things consistent.

Adding a plugin to the Esia interface

First, copy the executable of your plugin to the Esia server in the directory /usr/local/esia/plugins/ (Check that the file has execution rights X)

On the web interface, go to the menu « Administration Administration ». Go to « Plugins » then click on the Add a plugin at the top right.

 Add a plugin

This will open a new window.

 Set up the new plugin

Configure the new plugin:

  • Plugin nameThe name it will have in the interface. Plugin Nomenclature)

  • Access pathThe path and name of the executable file from the directory on the server /usr/local/esia/plugins/ (Check that the file has execution rights X).

    ExampleOn the image above, our executable is located at the root of the /usr/local/esia/plugins/

  • Type: This option will be implemented in the future.

  • SNMP trap OID: This option will be implemented in the future.

  • Settings*: Here you can configure the default options to be passed to the plugin.

  • Interval*: Default time between plugin executions in milliseconds (300 = 5 minutes).

  • Priority* Choose a default priority for the test (See Adding services => Priority of services).

  • DescriptionWhat this plugin does.

* Parameters, Interval and Priority are default values. They can be modified on a case-by-case basis for each node if necessary.

Don't forget to click on “Add” at the bottom left to save the plugin.

en/advanced/creer_plugin.txt · Last modified: 2023/11/09 18:18 by