Supervision
Überwachung des Servers
Auf Serverebene wird empfohlen, die folgenden Aspekte der Maschine zu überwachen:
- Festplatten Auslastung
- Arbeitsspeicher Nutzung
- CPUs Auslastung
⚠️ Im Falle eines schwerwiegenden Fehlers in einem BlueMind-Komponenten wird eine Datei .hprof im Verzeichnis/var/log generiert.
Es ist von höchster Wichtigkeit, auf das Auftreten solcher Dateien zu achten.
Standardmäßig erkennt das BlueMind-System das Auftreten einer solchen Datei und zeichnet es als Fehler in die Datei /var/log/bm-node/node.log auf.
hprof-Dateien können manuell über den Befehl :
ls /var/log/\*.hprof
Die Datei wird wie folgt benannt:
java_pid1664.hprof
wo 1664 die Prozess-ID ist, die von der Panne betroffen war. Mit dieser ID ist es möglich, über die Befehle ps oder jps den für den Fehler verantwortlichen Komponenten vor dem Neustart der BlueMind-Dienste wiederherzustellen.
Für weitere Informationen zu hprof-Dateien und ihrer Verwaltung, siehe die Seite HPROF-Dateien erscheinen auf dem BlueMind-Server.
Überwachung der Dienste
BlueMind verwendet Standard-E-Mail-Komponenten (Postfix, nginx, ElasticSearch...), die mit Standard-Tools überwacht werden können.
Darüber hinaus ermöglichen die APIs die Abfrage des Servers auf die gleiche Weise wie die Schnittstellen, so dass sichergestellt werden kann, dass die BM-Core-Komponente ordnungsgemäß funktioniert.
Die Liste der BlueMind Prozesse, die auf dem Server laufen, ist über den Befehl :
/usr/lib/jvm/bm-jdk/bin/jps -ml
Unter normalen Umständen sind die erwarteten und überwachbaren reinen BlueMind-Prozesse :
-
net.bluemind.eas.push -
org.elasticsearch.bootstrap.Elasticsearch start -p /var/run/bm-elasticsearch.pid -
net.bluemind.lmtp.id1 -
net.bluemind.ysnp.ysnp -
net.bluemind.application.launcher.coreLauncher -
net.bluemind.webmodules.launcher.webLauncher -
net.bluemind.node.server.nodelauncher -
net.bluemind.tika.server.tika
Zu den Standardkomponenten, die von BlueMind verwendet werden, gehören auch :
- PostgreSQL
- Postfix
- nginx
- bm-php-fpm
- ElasticSearch
Nutzung von SNMP
BlueMind stellt keine SNMP-Sonden zur Verfügung. Um einen BlueMind Server über SNMP überwachen zu können, müssen Sie daher die Überwachung jedes der oben genannten Dienste manuell einrichten.
BlueMind Überwachungsskripte
Um die BlueMind-Dienste überwachen zu können, muss das Paket bm-checks installiert sein.
Nach der Installation des Pakets stehen Überwachungsskripte im Verzeichnis /usr/share/bm-checks/ zur Verfügung.
Um sie zu nutzen, starten Sie die Ausführung dieser Bash-Skripte regelmäßig, z.B. mit einem Cron.
Jedes Skript gibt einen Rückgabecode zurück, der vom Status des BlueMind-Dienstes abhängt:
- 0 (Null), wenn der Dienst funktioniert
- 1 (eins), wenn ein geringfügiges Problem festgestellt wird
- 2 (zwei), wenn ein Fehler festgestellt wird
Im Falle eines Fehlers wird eine Meldung über den Standardausgang zurückgegeben.
Überwachung der Logs
Die Protokolldateien der BlueMind-Komponenten sind im Verzeichnis /var/log abrufbar:
/var/log/bm//var/log/bm-eas//var/log/bm-elasticsearch//var/log/bm-mapi//var/log/bm-mq//var/log/bm-node//var/log/bm-tika//var/log/bm-webserver//var/log/bm-webmail//var/log/bm-ysnp/
Für andere Komponenten, die überwacht werden können, können die folgenden Orte verwendet werden:
/var/log/mail.err/var/log/mail.info/var/log/mail.log/var/log/mail.warn/var/log/nginx//var/log/bm-php-fpm/bm-php-fpm.log/var/log/postgresql/
Skriptsteuerung
BlueMind verwendet Standardsystemskripte zum Stoppen und Starten von Diensten.
So startet der Befehl "bmctl restart" alle BlueMind-Dienste neu.
Durchführung von Operationen per Skript
Wie in den Abschnitten über die Integration mit Drittanwendungen beschrieben, kann BlueMind vollständig skriptgesteuert sein.
Über die Client-APIs (in PHP und Java) können Sie jede beliebige Operation in BlueMind ausführen, insbesondere einen Benutzer anlegen oder ändern, auf einen Kalender zugreifen, ein Ereignis hinzufügen....