Collectd
Plugin to integrate collectd with Pandora FMS.

Introduction
The pandora_collectd plugin is responsible for integrating the collectd collection with the Pandora FMS server and agents. We are faced with a Server and EndPoint plugin.

Compatibility matrix
Systems where it has been tested 

 CentOS 7, Rocky Linux 8 and Ubuntu 22.04 

 

 

 Systems where it works 

 Any x86_64 Linux system 

 

 

 

 This plugin is not compatible with ARM systems

Pre-requisites
Have Collectd installed and configured. 

 On newer Linux operating systems (such as Rocky Linux 8 or Ubuntu 22.04) it is necessary to install the collectd-utils dependency. This dependency is not necessary, for example, on CentOS 7. 

 Execution permissions of the pandora_collectd plugin.

Parameters
-h, --help 

 Help information on the plugin arguments. 

 

 

 -c, --collectdctl 

 Path of collectdctl . 

 

 

 -r, --add_regexp 

 Regular expression (regexp) to add metrics (by default .* ). 

 

 

 -R, --ignore_regexp 

 Regular expression (regexp) to remove metrics (by default none). 

 

 

 -d, --agent_description 

 Description of the agent created by the plugin (by default "Agent from pandora_collectd"). 

 

 

 -a, --agent_alias 

 Name of the agent created by the plugin (by default pandora_collectd ). 

 

 

 -i, --tentacle_ip 

 IP address of the Tentacle server (by default 127.0.0.1). 

 

 

 -p, --tentacle_port 

 Tentacle port (by default 41121). 

 

 

 -O, --tentacle_extra_opts 

 Tentacle extra options (by default none) 

 

 

 -v, --verbose 

 Displays all values obtained on the screen. 

 

 

 

 Python regular expressions https://docs.python.org/3/library/re.html#regular-expression-syntax  

Ejecución manual
Default execution 

 ./pandora_collectd 

 Execution with regular expressions 

 ./pandora_collectd -r ".*cpu.*" -R ".*memory.*" 

 Execution with agent name, description and address of Tentacle 

 ./pandora_collectd -a Monitores_Servidor -d "Monitores del Servior Web" -i 127.0.0.1

PandoraFMS configuration
This plugin can be configured as a server plugin or as an agent plugin. 

 Server Plugin 

 1. We can upload the plugin to our server in the default path: 

 /usr/share/pandora_server/util/plugin 

   

 2.Go to the plugins section and add a new one: 

 

 3. Add the name, description and timeout of the plugin: 

 

 4. Enter the execution path of the plugin and all the parameters we are going to use: 

 

 When executing the plugin in the Pandora FMS server in this case, we can introduce the parameters directly in the "Plugin Command" section. If, in spite of this, we want to modify the parameters of the plugin, we will introduce them with macros in the "Plugin Parameters" section to indicate them later in the creation of the module. 

 

 

 

 

 5. We create the plugin module in one of our Pandora FMS agents: 

 

 6. We indicate the plugin and the data we want to modify and create the module: 

 Agent Plugin 

 1. We can upload the plugin to our agent in the default path: 

 /usr/share/pandora_agent/plugins 

   

 2. Access to the Plugins configuration of our agent and add the plugin with the parameters we want:

Agent and modules generated by the plugin
The execution of the plugin (in agent or server) will result in the creation of a Pandora FMS Agent, with the modules corresponding to the collection of collectd monitors: