We are working on the translation of the Pandora FMS documentation. Sorry for any inconvenience.
The plugins allows to Pandora FMS to get information that requires a complex process or that requires the use of complex systems or APIs. Examples of plugins could be the Oracle® database monitoring that requires a complex process for the monitoring and also some auto-discovery tasks. Other example could be a simple HTML parse, but that requires some that Goliat (checking web server) can't do.
Pandora FMS offers two possibilities when executing plugins: execution in the Software agent or in the server.
To do recon tasks on plugins that need it, we have two possibilities:
The first one consists on using the the Pandora server Recon server. To do this, it will be necessary to create the ad-hoc code for the specific technology or situation.The Recon Tasks loads the Pandora server, so,if for doing the recon task are necessary lot of data requests, this option should't be consider.
It is also possible to create a recon task using an agent plugin. Usually, the agent plugins returns modules that are attached to the XML that the agent sends to the Pandora server. But, consider that when installing the agent in a machine with it, Tentacle is also installed, and this allow to send XML to the Pandora server. To do a recon task from an agent plugin, it is possible to use this, and besides adding the modules to the agent as a common plugin does, to give our plugin the capacity to send XMLs to Pandora with the information of other agents updated as a recon task would do.
The idea is that the plugin, besides creating the average modules,collects the information and create and send the XML simulating other agents installed if necessary.
The reason to create a plugin that sends data through XML and besides does recon task is to could distribute the monitoring load in different machines and not centralize it in the server.
A server plugin should be used when:
An agent plugin will be used when:
In order that all plugins would be the more standard possible, and that they have similar features, you should consider the following aspects:
Pandora FMS follows a system of versions for the plugins that has the following format:
v1r1
Being:
vX
: plugin version, the step of one version to another is made when a new important functionality is added or an error that makes impossible the correct working of the plugin is corrected.The first version is the v1
.rY
: revision of the plugin, the transition from one revision to another occurs when a bug is fixed or a minor functionality is implemented. The first revision is r1
.
Always that there would be a change to a new version, should be started by the first revision, that is, if a plugin is in v1r5
version and for get a higher number of version, then version becoms to v2r1
.
All plugins should respond to a call without parameters or with a short option type -h
or long type -help
, showing the command for its execution and the different parameters of it. Besides, it will be necessary to show the version of the plugin. For example:
$ ./myplugin myplugin version: v1r1 Usage myplugin <param1> <param2> <param3>