Konfiguration des Bloonix-Servers

Die Konfiguration des Servers befindet sich in:

/etc/bloonix/server/main.conf

Globale Parameter

user bloonix
group bloonix
timezone Europe/Berlin
hostname yourhostname
allow_from 127.0.0.1
elasticsearch_roll_forward /var/log/bloonix/elasticsearch-roll-forward.json

Roll-Forward-Log

Jedesmal, wenn Elasticsearch nicht erreichbar ist oder ein Fehler auftritt, werden Inserts und Updates in eine Datei geschrieben. Wenn zum Beispiel Elasticsearch nach einem Update einen Cluster-Restart erfordert, landen alle Aktionen in der Datei. Diese Einträge können später importiert werden. Das Kommando hierzu lautet:

bloonix-roll-forward-log

Das Skript läd automatisch die Serverkonfiguration und importiert vorhandene Einträge im Logfile nach Elasticsearch. Das Skript geht dabei wie folgt vor:

• Logfile umbenennen nach elasticsearch-roll-forward.json.import.
• Eine Datei namens elasticsearch-roll-forward.json.import.count anlegen, um den Verarbeitungsstatus zu speichern.
• Das Logfile elasticsearch-roll-forward.json.import wird importiert.
• Bei Verbindungsfehlern werden die Datensätze in elasticsearch-roll-forward.json geschrieben.
• Nach dem Durchlauf werden die temporären Dateien elasticsearch-roll-forward.json.import und elasticsearch-roll-forward.json.import.count entfernt.

Ist das Skript einmal gestartet, sollte es auf keinen Fall gestoppt werden. Das Skript merkt sich zwar, bis zu welcher Zeile die Daten verarbeitet wurden, trotzallem kann zu einem Verlust oder zu doppelten Einträgen kommen, wenn der Verarbeitungsprozess seinen Status nicht erfolgreich auf die Platte schreiben konnte.

Sektion: proc_manager

In dieser Sektion findet die Verwaltung der Prozesse statt, die der Bloonix-Server startet, um Anfragen zu bearbeiten.

proc_manager {
    max_servers 10
    min_spare_servers 5
    max_spare_servers 8
}

Sektion: tcp_server

In dieser Sektion werden die Parameter für den TCP Server konfiguriert. Die Konfiguration ist sehr einfach.

tcp_server {
    port 5460
    use_ssl yes
    ssl_key_file /etc/bloonix/server/pki/server.key
    ssl_cert_file /etc/bloonix/server/pki/server.cert
}

Sektion: notifications

In der Sektion notifications werden die Subsektionen zur Konfiguration von E-Mail und SMS Benachrichtigungen konfiguriert.

notifications {
    sms {
        command /usr/bin/curl -s https://sms.test?key=SECRET&from=BLOONIX&to=%TO%&message=%MESSAGE%
        response ^100$
    }
    mail {
        from subdomain@yourdomain.test
        bcc admin@yourdomain.test
        subject *** STATUS %s FOR %h (%a) ***
    }
}

Subsektion: sms

Subsektion: mail

Diese Sektion wird für das Versenden von E-Mails an Kontakte konfiguriert.

Sektion: redirect_remote_agent_timeouts

Die Sektion redirect_remote_agent_timeouts bietet ein ganz spezielles Feature an, welches nur verwendet werden sollte, wenn Sie Kundenserver über Bloonix überwachen und wenn die Kunden als Kontakt für Benachrichtigungen eingerichtet sind.

Stellen Sie sich folgendes Szenario vor:

Sie bieten Ihren Kunden Monitoring über Bloonix an und haben hierfür einen Agenten eingerichtet, der zum Beispiel per Remote-Check die Webseiten Ihrer Kunden überwacht. Wenn dieser Agent ausfallen würde, dann würden Ihre Kunden nach Ablauf eines Timeouts eine kritische Meldung per E-Mail oder SMS erhalten, da der Service seit mehreren Minuten nicht mehr geprüft wurde. Was hier beachtet werden muss ist, dass weder der Webserver des Kunden ausgefallen ist, noch ein Agent, der auf einem Kundenserver läuft. Der Kunde würde also über einen kritischen Zustand informiert, den der Kunde nicht zu verantworten hat, da in diesem Fall der Agent ausgefallen ist, der auf Ihrem Server und in Ihrem Zuständigkeitsbereich läuft, um die Webseiten Ihrer Kunden zu überwachen.

Um nun zu vermeiden, dass Kunden in diesem Fall fälschlicherweise benachrichtigt werden, gibt es den Parameter mail_to in der Sektion redirect_remote_agent_timeouts. Der Kunde selbst würde keine SMS und auch keine E-Mail mehr für Services erhalten, die mit der Option Standort des Agenten: remote konfiguriert sind, stattdessen würden die Benachrichtigungen per E-Mail an die Adresse umgeleitet, die mit dem Parameter mail_to gesetzt ist.

Die Konfiguration der Sektion ist sehr einfach:

redirect_remote_agent_timeouts {
    mail_to foo@example.test
}

Möchten Sie diese Funktion nicht einsetzen, so können Sie die Sektion auskommentieren.

Sektion: database

In dieser Sektion werden die Parameter für die Datenbank konfiguiert und sind selbsterklärend.

database {
    include /etc/bloonix/database/main.conf

    #driver Pg
    #host 127.0.0.1
    #port 5432
    #database bloonix
    #user bloonix
    #password secret

    logger {
        file {
            filename /var/log/bloonix/bloonix-server-database.log
            filelock 0
            maxlevel info
            minlevel emerg
            message_layout [%T] %L %P %t %X %Y %m (%C)
        }
    }
}

Die Konfiguration des Loggers ist identisch zur Konfiguration des Haupt-Loggers weiter unten.

Sektion: elasticsearch

In dieser Sektion werden die Verbindungsparameter zu Elasticsearch konfiguriert.

elasticsearch {
    proto http
    host 127.0.0.1:9200, 127.0.0.2:9200
    timeout 60
    mode balanced
}

Sektion: logger

Hier findet die Konfiguration des Logger statt. Weitere Informationen zu den Einstellungsmöglichkeiten finden Sie unter
http://search.cpan.org/dist/Log-Handler/ .

logger {
    file {
        filename /var/log/bloonix/bloonix-server-database.log
        filelock 0
        maxlevel info
        minlevel emerg
        timeformat %b %d %Y %H:%M:%S
        message_layout [%T] %L %P %t %X %Y %m (%C)
    }
}