Collectd
Plugin to integrate collectd with Pandora FMS.
- Introduction
- Compatibility matrix
- Pre-requisites
- Parameters
- Ejecución manual
- PandoraFMS configuration
- Agent and modules generated by the plugin
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
- 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: