ServerMonitor v1.23 Dokumentation

Transkript

1 ServerMonitor v1.23 Dokumentation Der ServerMonitor ist ein Programm zur Überwachung von Systemen. Er überwacht mehrere Instanzen gleichzeitig. Für jede Instanz können beliebig viele Prüfungen eingerichtet werden. Jede Prüfung vergleicht einen Testzeichenkette mit dem Prüfungsoutput und ermittelt einen boolschen Prüfwert von OK oder Nicht OK. Sind alle Prüfungen korrekt gelaufen, wird der Status GRÜN angezeigt. Ist mindestens eine Prüfung fehlgeschlagen, schlägt das Programm Alarm und zeigt den Status ROT. Mit Version 1.2 ist eine neue Schwellwertprüfung hinzugekommen. Gibt man einen Schwellwert für eine maximale Prüfungszeit eines Checks an (z.b. laden einer URL), wird diese ausgewertet und setzt ggf. den Status ORANGE für Kritisch. Ebenfalls neu hinzugekommen ist ein einfacher -Versand über SMTP bei kritischen und fehlerhaften Zuständen einer Instanz (Status ORANGE, ROT). Es gibt verschiedene Prüfungstypen (Checks): 1. URL-Check / Lädt eine Datei anhand eine URL oder Dateiangabe. Der Prüfungsinhalt ist der Seiteninhalt bzw. Dateiinhalt 2. FTP-Check / Führt FTP-Befehle auf einem FTP-Server aus. Der Prüfungsinhalt sind die jeweiligen Antworten des FTP-Servers aller Kommandos. 3. Datenbank-Check / Führt SQL-Befehle auf einer Datenbank aus (Anbindung über JDBC). Der Prüfungsinhalt ist der Inhalt aller Datensätze und aller Datenfelder des Result-Sets. 4. Programm-Check / Führt ein beliebiges Programm aus. Der Prüfungsinhalt ist der Output oder Fehlerkanal (je nach Auswahl). 5. LDAP-Check / Führt eine LDAP-Abfrage durch. Der Prüfungsinhalt sind die Antwortdaten vom LDAP-Server 6. Mail-Check / Sendet eine über SMTP (ohne Passwort) durch. Der Prüfungsinhalt ist die Antwort vom SMTP-Server. Somit können Sie die verschiedensten Komponenten eines Systems auf Läuffähigkeit überwachen. Durch Programm-Checks können Sie eigene Prüfungsprogramme verwenden, in dem Sie mittels einer Batchdatei den Errorlevel auswerten und bei einem erfolgreichem Return-Code den Teststring auf dem Outputkanal ausgeben.

2 A. Starten des Programms Es handelt sich um ein Javaprogramm, welches eine korrekte Installation der JRE1.4 oder höher vorraussetzt. Mit einem Doppelklick auf ServerMonitor.jar wird das Programm gestartet. Der Systempath auf die java.exe muss vorhanden sein. (Siehe auch Kapitel E) B. Programm einstellen Auf dem Reiter Programm nehmen Sie die Einstellungen vor, die für alle Instanzen und Prüfungen gilt. Alle Eingaben werden erst nach dem Speichern wirksam. System-Output: Gibt alle Meldungen der Statuszeile zusätzlich in der Konsole (z.b. DOS-Box) aus. Prozess-Output: Gibt an, ob eine Ausgabe der Checkantworten (Prüfungsinhalt) in der Konsole erfolgt. Dies ist z.b. nützlich, wenn man nicht genau weiß, welche Antwort z.b. ein Prozess oder Server gibt und welchen Teststring man einstellen sollte. Socket-Port: Gibt den SocketPort aller HTTP-Connection an (URL-Check). Dieser ist standardmäßig 80 und sollte nicht verändert werden. Socket-Timeout: Gibt den Timeout für folgende Checks in Sekunden an: URL-Check, FTP-Check, DB- Check, Mail-Check. Proxy-Server benutzen: Für alle URL-Checks kann ggf. ein Proxy-Server verwendet werden. Wählen Sie dazu diese Option aus und geben den Proxy-Server, den Proxy-Port und die Anmeldedaten (Benutzer, Passwort) für diesen an. Achtung: Die Einstellung gibt es ebenfalls nochmal für jeden URL-Check. Beide Optionen müssen gewählt werden, damit ein Proxy-Server benutzt Es ist also ein globaler An/Aus- Schalter. s für fehlerhafte Instanzen versenden: Es gibt die Möglichkeit, bei einem Fehler (Status ROT), eine über SMTP zu versenden. Wählen Sie dazu diese Option an und geben den SMPT-Server, die Absende und Empfänger- -Adressen als auch den Betreff an. Achtung: Es gibt noch eine Option Mail auf dem Monitor-Reiter, die für die jeweilige Instanz ausgewählt werden muss, um s zu versenden. s für kritische Instanzen versenden: Ähnlich wie die vorherige Option gibt es die Möglichkeit, bei kritischen Zuständen (Status ORANGE), eine über SMTP zu versenden. Wählen Sie dazu diese Option an und geben den SMPT-Server, die Absende und Empfänger- -Adressen als auch den Betreff an. Achtung: Es gibt noch eine Option Mail auf dem Monitor-Reiter, die für die jeweilige Instanz ausgewählt werden muss, um s zu versenden. nur unterschiedliche Meldungen senden: Wird diese Option ausgewählt und ist ein Fehler aufgetreten, wird daraufhin ggf. eine versendet. Tritt der gleiche Fehler nochmals auf, wird ein Mailsenden ignoriert. Sollten anderen Fehler auftreten, werden diese versendet. Diese Option soll bei kurzen Prüfintervallen ein Zumüllen via verhindern.

3 C. Instanzen anlegen Es sind standardmäßig 3 Instanzen angelegt. Sollten Sie mehr Instanzen benötigen, müssen Sie mit dem PLUS-Button eine neue Instanz anlegen oder mit dem KOPIE-Button eine ausgewählte Instanz kopieren. Vergeben Sie anschließend einen eigenen kurzen Instanznamen. Prüfintervall setzen Gehen Sie zunächst im Programm auf den Reiter Einstellungen und wählen in der Combo-Box eine Ihrer Instanzen aus. Sie können für die Instanz eine Checkzeit eingeben, d.h. das die Prüfungen nur innerhalb dieser angebenen Zeitspanne täglich laufen. Benutzen Sie die obigen Eingabefelder läuft von und läuft bis. Das Eingabe-Format ist HH:MI, siehe Tooltip. Lassen Sie die Felder leer, dann wird permanent geprüft. Die Option im Monitor anzeigen sagt aus, das diese Instanz auf dem ersten Reiter Monitor angezeigt wird und dort auch gesteuert werden kann. Der Prüfungsabstand wird im Eingabefeld Intervallzeit definiert. Möchten Sie alle Komponenten nur aller 5 Minuten prüfen, geben Sie 300 (300 Sekunden) ein. Statt der normalen Zeitangaben können Sie auch einen Crontabeintrag benutzen. Wählen Sie dazu die Option Crontabeintrag benutzen aus, und machen Sie eine gültige Angabe. Ein Crontabeintrag entspricht einer genauen Prüfzeitangabe wie im Unix für Cronjobs. Lesen Sie mehr über Crontabsyntax im Internet (z.b. ). Minuten ( * für jede Minute ) Stunden ( * für jede Stunde ) Tage ( * für jeden Tag ) Monate ( * für jeden Monat ) Wochentage ( * für jeden Wochentag ( 0 und 7 adressieren den Sonntag )) Fehlermailbehandlung verändern Möchten Sie für diese Instanz andere Einstellungen für die Fehlermails bzw. Hinweismails vornehmen, müssen die die Checkbox separate Fehlermailbehandlung für diese Instanz auswählen. Sie können dann die adressen, den Betreff und die Auswahl Fehlermails JA/Nein oder Hinweismails JA/NEIN verändern. So ist es mit den Programmeinstellungen z.b. möglich, generell alle Fehlermails an eine adresse test_mueller@ .de zu senden, jedoch alle Fehlermails einer bestimmten Instanz an die adresse test_schulze@ .de zu verschicken. Checks (Prüfungen) einrichten Als nächsten wählen Sie eine Instanz aus und einen Check bzw. legen einen neuen Check mit dem Button PLUS an. Wählen Sie einen Checktypen aus und bestätigen mit OK. Der Typ erschein nun am Ende der Liste. Wählen Sie diesen nochmals aus und füllen alle Eingabefelder aus, um den Check zu definieren.

4 Jeden Check kann man mit der obersten CheckBox aktivieren bzw. deaktivieren. Beim deaktivieren werden auch die Eingabefelder deaktivert. Die Prüfung wird nicht ausgeführt, steht aber weiterhin in der Liste. Für jeden Check gibt es eine Eingabe für einen Schwellwert. Dieser gibt die maximale Ausführungszeit des Checks (Prüfungszeit) an. Wird dieser Wert erreicht oder überschritten, wird der Status ORANGE (Kritisch) gesetzt. Lassen Sie dieses Feld leer, um diese Prüfung zu überspringen. Checkinhalte können auch von einem Check in einen anderen kopiert werden. Die Werte können jedoch nur in den gleichen Checktyp übertragen werden. Markieren Sie dazu einen Check und drücken den KOPIE-Button. Dieser verwandelt sich dabei in einen EINFUEGE-Button. Markieren Sie nun einen anderen Check vom gleichen Typ und drücken Sie den EINFUEGE-Button. URL-Check Proxy-Server benutzen: Gibt an, ob Sie einen Proxy-Server benutzen möchten. Es gibt noch eine gleiche Option unter dem Programm-Reiter. Beide müssen aktiv sein, damit der Proxy-Server benutzt Application-URL: Geben Sie eine URL bzw. den Pfad einer Datei ein. Für den Pfad einer Datei beginnen Sie mit file://, z.b. file://s:\temp\testdatei.txt. POST-Variablen: Möchten Sie zusätzlich an die gewählte Adresse noch einfache Daten posten, geben Sie kommaseperiert die Variablen-Wert-Pärchen nach folgendem Format ein: Variable=Wert. Z.B. name=testuser, password=testpasswort. Möchten Sie keine Daten posten, lassen Sie das Feld leer. HTTP-Authedifizierung: Mit der Auswahl müssen Sie zusätzlich Benutzer und Passwort eingeben. Sollte die URL Webserverseitig Passwortgeschützt sein, muss diese Option ausgewählt werden.

5 Programm-Check Programm: Geben Sie hier das Programm inklusive Pfad ein. Der Prüfinhalt ist die Programmausgabe entweder auf dem Standartoutputkanal oder auf dem Fehlerkanal, je nach Auswahl des Lesekanals. Sollte das Programm nur einen Returncode liefern, können Sie eine Batchdatei erstellen, die das Programm aufruft, den Returncode ausliest und eine entsprechende Ausgabe off rem Test auf Datei dir F:\sqldeploy.ini if %errorlevel% == 0 goto :ok echo Fehler mit RC=%errorlevel% goto :end :ok echo Programm OK :end pause Lesekanal: Gibt an, in welchem Ausgabekanal der Teststring gesucht

6 Datenbank-Check DB-Treiber: Der Datenbankzugriff erfolgt über JDBC. Sie sollten einen JDBC-Treiber für Ihre Datenbank vom Anbieter downloaden. Diese gibt es fast für alle Datenbanken. Geben Sie den Datenbanktreiber an. Mehr zum Thema Treiber einbinden weiter unten. (z.b. oracle.jdbc.driver.oracledriver) DB-Connection-String: Dieser dient für die Definition der Datenbank und ist DB-Anbieterspezifisch, genau wie der DB-Treiber-Name. (z.b. DB-User: Gibt den Benutzer der Datenbank an. DB-Passwort: Gibt das Passwort des Benutzers an. SQL-Befehl: Definiert die Datenabfrage der Datenbank für den Prüfungsinhalt. SQL- In dem Fall ist der Prüfungsinhalt alle Daten aus den selektierten Feldern und Sätzen. FTP-Check FTP-Server: Definiert den Servernamen bzw. die IP. FTP-Benutzer: Gibt den Benutzer für den FTP-Server an. FTP-Passwort: Gibt das Passwort des Benutzers an.

7 FTP-Kommando: Hier können mehrere FTP-Kommandos, wie z.b. CWD, LIST, STOR, durch Kommatrennung eingegeben werden. Der Prüfungsinhalt sind die Protokoll-Antworten vom Server. (mkd x, cwd x, stor prod.log, retr prod.log, dele prod.log, cwd.., rmd x: legt ein Ordner X an, macht einen Up- und Download der Datei prod.log und löscht alles). LDAP-Check LDAP-Server: Definiert den Servernamen und ggf den Port (Server:Port) LDAP-Benutzer: Gibt den Benutzer für den LDAP-Server an. LDAP-Passwort: Gibt das Passwort des Benutzers an. LDAP-Searchbase: Gibt die Suchbasis der LDAP-Suche an. Z.B. ou=stadt, o=firma, dc=de LDAP-Suchstring: Gibt den Suchstring für den LDAP-Server an. Informieren Sie sich dazu im Internet mit den Stichworten ldap suchanfrage syntax. Der Prüfungsinhalt sind alle gefundenen Daten, die der LDAP- Server sendet. Mail-Check Mail-Server: Gibt den SMPT (Mail-Eingang)-Server an. Mail-Adresse FROM: Gibt die Absende- -Adresse an. Mail-Adresse TO: Gibt die -Adresse des Empfängers an. Mail Betreff: Gibt den Betreff der an. Mail Text: Gibt den text an. Sollten HTML-Tags vorhanden sein, wird ein HTML-Format gesendet. Der Prüfungsinhalt sind die Protokoll-Antworten vom Server.

8 D. DB-Treiber für einen Datenbankzugriff einbinden Um einen JDBC-Treiber für Ihre Datenbank zu benutzen, müssen Sie Ihn zunächst aus dem Internet downloaden. Es sollte eine Jar Datei sein. Notieren Sie sich auch gleich den Treibernamen, der immer mit kompletten Namespace angegeben wird (z.b. für MySQL: org.gjt.mm.mysql.driver). Den müssen Sie auch beim DB-Check unter Treibernamen angeben. Diese Jar-Datei muss nun dem Javaprogramm bekannt gegeben werden, damit die Klassen geladen werden können. Verwenden Sie dazu in der start.bat Datei folgende Classpath-Angabe: set classpath=servermonitor.jar;ihrdbtreiber.jar E. Start über Konsole oder Batchdatei Sie können das Programm auch Zeitgesteuert mit einem Zeitplaner etc. aufrufen. Um die jeweiligen Instanzprüfungen zu starten, geben Sie den Parameter s mit den gefolgten Instanznummern an. Die Instanznummer wird für die sichtbaren Instanzen im Monitor-Reiter von links nach rechts durchgezählt (beginnend mit 1). z.b. java org.kadiba.servermonitor.gui.maindialog s 1,2,3 Es werden die Instanzen 1,2 und 3 angestartet. Möchten Sie z.b. den Process-Output aller Prozesse aufzeichnen, wählen Sie zunächst die Option in den Programmeinstellungen und leiten den Standardoutput in eine Datei um. z.b. java org.kadiba.servermonitor.gui.maindialog > output.txt bzw. z.b. java org.kadiba.servermonitor.gui.maindialog s 1,2,3 > output.txt

9 F. Monitoring Wählen Sie den Reiter Monitor aus. Alle Instanzen, die in den Einstellungen die Option im Monitor anzeigen haben, werden hier angezeigt. Sie können die definierten Prüfungsablaufe jeder Instanz mit dem Button START anstarten bzw. mit STOP beenden. Darunter wird der jeweilige Status ROT oder GRÜN angezeigt. Wählen Sie die Option Ton, ertönt bei Status ROT ein Warnton. Mit der Option Log wird eine Ausgabe jedes Checks und dessen Ausführungszeit in einer Logdatei vorgenommen. Ist die Option Mail gewählt, wird ggf. eine im Fehlerfall bzw. in kritischen Zuständen gesendet. Mit einem Klick auf das Statusfeld öffnet sich die ggf. erstellte Logdatei. Beim ersten mal müssen Sie ein Programm (Editor) auswählen, mit dem die Logdatei betrachtet werden soll. Sie können jederzeit auf den Reiter Checkzeiten wechseln und dort eine Check-Instanz auswählen. Die Checks und deren Ausführungszeiten werden hier grafisch dargestellt. Fensterverhalten: Sollten Sie die Fenstergrösse gegenüber dem Standard verkleinern, zieht sich das Fenster beim Reiter Monitor so weit zusammen, das es wenig Platz wegnimmt. Für die anderen Reiter klappt es wieder auf. Viel Spass Ihr Kadiba-Team