Konfiguration des Bloonix-Agenten

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

Parameter: worker

Standard: 4

Hier können Sie die Anzahl der Prozesse angeben, die gestartet werden sollen. Auf diese Prozesse werden alle Aufgaben des Agenten verteilt, wie zum Beispiel Host Konfigurationen beim Bloonix Server abfragen, Checks ausführen und den Status zum Bloonix-Server zu senden.

Parameter: max_concurrent_hosts

Standard: 0

Mit diesem Parameter können Sie die maximale Anzahl Hosts festlegen, die parallel geprüft werden. 0 bedeuted das der Wert automatisch ermittelt wird

Parameter: max_concurrent_checks

Standard: 0

Die Anzahl gleichzeitig ausgeführter Serviceprüfungen für einen Host. Je höher der Wert, desto mehr parallele Serviceprüfungen werden ausgeführt. Ein zu hoher Wert kann das System überlasten. 0 bedeuted, dass der Wert identisch zu der Anzahl worker ist.

Zusammenspiel worker, max_concurrent_hosts, max_concurrent_checks

Normalerweise wird der Agent zur Überwachung des lokalen Systems eingesetzt. In diesem Fall reicht es vollkommen aus die Werte auf ihre Standards eingerichtet zu lassen. Sollte es jedoch notwendig sein aufgrund der Masse an Service-Checks die Werte zu erhöhen, dann reicht es die Anzahl für den Parameter worker zu erhöhen.

Sollte der Agent jedoch mit einer Lokationsgruppe eingerichtet sein, dann wäre es sinnvoll die Parameter je nach Anzahl der Hosts (Router, Switches, etc.) anders zu setzen. Sind in einer Lokationsgruppe z.B. 100 Hosts mit je 40 Services konfiguiert, dann wäre es sinnvoll die Werte worker auf 100, max_concurrent_hosts auf 10 und max_concurrent_checks ebenfalls auf 10 zu setzen.

Parameter: user, group

Standard: bloonix

Der Bloonix-Agent 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.

Parameter: simple_plugin_path

Standard: /usr/lib/bloonix/simple-plugins, /usr/local/lib/bloonix/simple-plugins

Unter diesem Pfad können Nagios-kompatible Checks abgelegt werden.

Sektion: server

Hier werden die Verbindungsdaten zu den Bloonix-Servern konfiguriert.

Parameter: host

Es können multiple Ziele kommasepariert gesetzt werden.

Parameter: port

Der Port, unter dem die Bloonix-Server erreichbar sind.

Parameter: use_ssl

Standard: no

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

Parameter: ssl_verify_mode

Sollte der Bloonix-Server mit einem gültigen Zertifikat eingerichtet sein, so kann dieser Wert auf peer gesetzt werden, somit würde das Zertifikat validiert werden. Andernsfalls sollte der Wert auf none gesetzt werden.

Parameter: bind

Falls gewünscht kann eine Quell-IP gesetzt werden, von der aus sich der Bloonix-Agent zum Bloonix-Server verbindet.

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

Parameter: compression

Standard: zlib

Mit dem Parameter compression wird definiert, welche Komprimierungsmethode für die Kommunkation zwischen Bloonix-Agent und Bloonix-Server eingesetzt wird. Erlaubte Werte sind

• zlib
• gzip
• brotli
• lz4

Es ist zu beachten, dass die entsprechenden Python 3 Module installiert sein müssen. Die Module zlib sowie gzip sind fester Bestandteil von Python 3. Darüber hinaus müssen die Komprimierungsmethoden beim Bloonix-Server aktiviert sein.

Sektion: host

In dieser Sektion wird die Host-ID und das Passwort eingerichtet, für die der Agent die Service-Checks ausführen soll.

Sektion: location_group

In dieser Sektion wird die Lokations-ID und as Password eingerichtet, für die der Agent die Service-Checks ausführen soll.

Sektion: environ

Über die Sektion environ lassen sich Umgebungsvariablen für den Bloonix Server setzen.

Parameter: include

Über den Parameter include können Verzeichnisse inkludiert werden. Alle Dateien mit der Endung .conf werden inkludiert.