Konfiguration des Bloonix-Satelliten

Die Konfiguration des Bloonix-Satelliten liegt in der Datei /etc/bloonix/satellite/main.conf. Die meisten Parameter, wie zum Beispiel Pfade, sollten nur unter speziellen Bedingungen angepasst werden.

Parameter: authkey

Der Authkey wird als Authentifizierung verwendet und in der Bloonix-WebGUI eingerichtet. Der Authkey sollte eine Mindestlänge von 32 Zeichen haben. Empfohlen wird eine Länge von 64 Zeichen.

Parameter: user, group

Standard: bloonix

Der Bloonix-Satellit läuft standardmäßig unter dem Benutzer und der Gruppe 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.

Sektion: proc_manager

In dieser Sektion wird der Prozessmanager konfiguiert.

Parameter: worker

Die Anzahl der Prozesse, die gestartet werden sollen um die Anfragen der Bloonix-Server zu verarbeiten.

Sektion: tcp_server

Hier werden die Einstellungen für den TCP Server gesetzt, um die Anfragen der Bloonix Server zu verarbeiten.

Parameter: port

Die Portnummer, auf die der Satellit für eingehende Anfragen lauschen soll.

Parameter: use_ssl

Standard: no

Standardmäßig ist SSL ausgeschaltet. SSL sollte jedoch in jedem Setup eingeschaltet sein.

Parameter: ssl_key_file

Angabe des privaten SSL Schlüssels.

Parameter: ssl_cert_file

Angabe des öffentlichen SSL Schlüssels.

Parameter: ssl_dh_params

Angabe des Diffie-Hellman Schlüssels, falls gewünscht. Ein Schlüssel kann wie folgt generiert werden:

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

Parameter: ssl_protocol

Standard: ssl.create_default_context(), siehe (https://docs.python.org/3/library/ssl.html)

Angabe der niedrigsten SSL/TLS Protokoll Version.

Parameter: ssl_cipher_suite

Standard: ssl.create_default_context(), siehe (https://docs.python.org/3/library/ssl.html)

Eine Liste der verfügbaren Ciphersuites lässt sich wie folgt ermitteln:

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

Sektion: server_status

Ist der Server Status aktiviert, so kann der Bloonix-Satellit selbst überwacht werden, z.B. von einem anderen 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