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