Configuration of the Bloonix-Satellite

The configuration of the Bloonix satellite is located in the file /etc/bloonix/satellite/main.conf. Most parameters, such as paths, should only be adjusted under special conditions.

Parameter: authkey

The Authkey is used for authentication and is set up in the Bloonix WebGUI. The Authkey should have a minimum length of 32 characters. A length of 64 characters is recommended.

Parameter: user, group

Default: bloonix

By default, the Bloonix satellite runs under 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.

Section: proc_manager

In this section the process manager is configured.

Parameter: worker

The number of processes to start to process requests from the Bloonix servers.

Section: tcp_server

Here the server settings for the satellite are set to answer the requests of the Bloonix agents.

Parameter: port

The port number on which the server should listen for incoming requests.

Parameter: use_ssl

Default: no

By default, SSL is turned off. However, SSL should be turned on in every setup.

Parameter: ssl_key_file

Specifying the private SSL key.

Parameter: ssl_cert_file

Specifying the public SSL key.

Parameter: ssl_dh_params

Specify the Diffie-Hellman key, if required. A key can be generated as follows:

openssl dhparam -out /etc/bloonix/server/dhparam.pem 2048

Parameter: ssl_protocol

Default: ssl.create_default_context(), see (https://docs.python.org/3/library/ssl.html)

Angabe der niedrigsten SSL/TLS Protokoll Version.

Parameter: ssl_cipher_suite

Default: ssl.create_default_context(), see (https://docs.python.org/3/library/ssl.html)

A list of available ciphersuites can be obtained as follows:

python3 -c 'import ssl; print(ssl.SSLContext().get_ciphers())'

Section: server_status

If the server status is activated, the Bloonix server itself can be monitored, e.g. by another monitoring system.

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