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.