Configuration of the Bloonix-Agent
The configuration of the Bloonix agent is located in the file /etc/bloonix/agent/main.conf. Most parameters, such as paths, should only be adjusted under special conditions.
Parameter: worker
Default: 4
Here you can specify the number of processes that should be started. All of the agent’s tasks are distributed across these processes, such as querying host configurations from the Bloonix server, running checks and sending the status to the Bloonix server.
Parameter: max_concurrent_hosts
Default: 0
With this parameter you can specify the maximum number of hosts that are checked in parallel. 0 means that the value is determined automatically.
Parameter: max_concurrent_checks
Default: 0
The number of service checks running simultaneously for a host. The higher the value, the more parallel service checks are running. A value that is too high can overload the system. 0 means that the value is equal to the number of workers.
Interaction worker, max_concurrent_hosts, max_concurrent_checks
Usually the agent is used to monitor the local system. In this case it is sufficient to leave the values set to their defaults. However, if it is necessary to increase the values due to the volume of service checks, then it is sufficient to increase the number for the worker parameter.
However, if the agent is set up with a location group, then it would be sensible to set the parameters differently depending on the number of hosts (routers, switches, etc.). For example, if 100 hosts with 40 services each are configured in a location group, then it would be sensible to set the values worker to 100, max_concurrent_hosts to 10 and max_concurrent_checks also to 10.
Parameter: user, group
Default: bloonix
The Bloonix-Agent runs by default with the user and group bloonix.
Parameter: plugins
Default: /usr/lib/bloonix/plugins, /usr/local/lib/bloonix/plugins
Die Plugins liegen für gewöhnlich unter /usr/lib, wenn diese aus einem Paket (deb, rpm) installiert wurden. Unter /usr/local können selbst entwickelte Skripts abgelegt werden, wenn diese manuell installiert werden.
Parameter: plugin_cache_dir
Default: /var/lib/bloonix/plugins
Einige Plugins legen Cache-Dateien an. Hier wird der Pfad definiert, wo die Cache Dateien abgelegt werden.
Parameter: simple_plugin_path
Default: /usr/lib/bloonix/simple-plugins, /usr/local/lib/bloonix/simple-plugins
Nagios compatible checks can be stored under this path.
Sektion: server
The connection data to the Bloonix servers are configured here.
Parameter: host
Multiple targets can be set separated by comma.
Parameter: port
The port under which the Bloonix servers can be reached.
Parameter: use_ssl
Default: no
By default, SSL is turned off. However, SSL should be turned on in every setup.
Parameter: ssl_verify_mode
If the Bloonix server is set up with a valid certificate, this value can be set to peer, which would validate the certificate. Otherwise, the value should be set to none.
Parameter: bind
If desired, a source IP can be set from which the Bloonix agent connects to the Bloonix server.
Parameter: compression
Default: zlib
The parameter compression defines which compression method is used for communication between Bloonix-Agent and Bloonix-Server. Allowed values are
- zlib
- gzip
- brotli
- lz4
Please note that the corresponding Python 3 modules must be installed. The modules zlib and gzip are an integral part of Python 3. In addition, the compression methods must be activated on the Bloonix server.
Sektion: logger
In der Sektion logger wird das Logging festgelegt.
Folgende Level stehen zur Verfügung:
- emergency
- alert
- critical
- error,
- warning
- notice
- info
- debug
Es stehen folgende Pattern zur Verfügung:
%L Log Level
%T Zeitstempel
%P PID
%H Hostname
%U Benutzername
%G Gruppenname
%N Neue Zeile
%S Name des Programms
%C Aufrufer - Dateiname und Zeilennummer
%r Laufzeit in Sekunden seit Programmstart
%t Zeitmessung - die Zeit seit dem letzten Aufruf von log()
%m Nachricht
Section: host
This section sets up the host ID and password for which the agent should perform service checks.
Sektion: location_group
In this section, the location ID and password are set up for which the agent should perform the service checks.
Section: environ
The environ section can be used to set environment variables for the Bloonix agent.
Parameter: include
Directories can be included using the include parameter. All files with the extension .conf are included.