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 Software Agent 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

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:

imagen.png

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

imagen.png

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

imagen.png

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.

imagen.png

imagen.png

imagen.png

imagen.png

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

imagen.png

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

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:

imagen.png

imagen.png

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:

imagen.pngimagen.png

imagen.png