Anhang E. Howto

Inhaltsverzeichnis

1. Benachrichtigung via E-Mail einrichten
1.1. Szenario
1.2. Voraussetzungen
1.3. Erläuterung
2. Host einem Container zuordnen
3. MonICA-Konsole einrichten
4. Neue Action hinzufügen
5. Neuen Container hinzufügen
6. Neues Mapping hinzufügen
7. Neuen Host hinzufügen
7.1. Szenario
7.2. Voraussetzungen
7.3. Erläuterung
8. Neuen Test hinzufügen
8.1. Szenario
8.2. Voraussetzungen
8.3. Erläuterung
9. Schwellewerte für Tests setzen

1. Benachrichtigung via E-Mail einrichten

1.1. Szenario

Ein Administrator soll eine E-Mail zugesendet bekommen, wenn ein überwachtes Zielsystem (fileserver.firma.de) den Status „Rot“ erreicht.

1.2. Voraussetzungen

  • das aktuelle Verzeichnis ist das MonICA-Installationsverzeichnis
  • es ist bereits ein Host mit Tests konfiguriert
  • für die Action-Klasse „email/smtp“ ist ein Plugin installiert (Standard)

Hinzufügen eines Hosts
Hinzufügen eines Monitors
Hinzufügen eines Tests

1.3. Erläuterung

Prozedur E.1. Schritt für Schritt

  1. E-Mail-Action hinzufügen

    1. Setup-Datei erstellen

      Zunächst muß eine Setup-Datei erstellt werden, z.B. local\setup\action\email.xml, die die Informationen enthält, die zum Erzeugen einer Action der Klasse „email/smtp“ benötig werden.

      Eine ausführlichere Beschreibung findet sich im Anhang.

    2. Action erzeugen

      Anschließend wird die Action mit dem mci-Befehl add erzeugt.

      MonICA>mci add local\setup\action\email.xml
      
      2
      
      MonICA>
      							

      Der Befehl gibt die ID (2) der neu generierten Action aus. Diese kann auch mit

      MonICA>mci ls action

      ermittelt werden. Da jede neue Action die höchste ID aufweist, entspricht die letzte ausgegebene Zeile dem gerade erzeugten Objekt.

  2. E-Mail-Action an Zielsystem binden

    Actions können an Tests, Hosts oder Host-Container gebunden werden. Entsprechend dem Szenario dieses Beispiels wird die neu erzeugte Action an einen Host gebunden. Diese Bindung wird durch mappen der Action auf den Host hergetstellt.

    Die E-Mail soll aber nur dann verschickt werden, wenn der Status des Hosts auf „Rot“ wechselt. Dies wird erreicht, indem das Mapping unter Angabe eines Prädikates, d.h., einer Aussage über den Test-Status, erstellt wird.

    MonICA>mci ls predicate

    zeigt die verfügbaren Prädikate an. für dieses Beispiel ist das Prädikat mit dem Namen is red das passende.

    MonICA>mci map action 2 host fileserver.firma.de "is red"

    Das neu generierte Mapping bedeutet: action 2 (email) ausführen wenn host fileserver.firma.de den status „Rot“ erreicht.

  3. Monitor hinzufügen

    Monitor

    Nun werden E-Mails zwar generiert, aber noch nicht verschickt, weil es keinen Empfänger oder, entsprechend der MonICA-Nomenklatur, Monitor dafür gibt.

    1. Setup-Datei erstellen

      Zunächst muß eine Setup-Datei erstellt werden, z.B. local\setup\monitor\admin.xml, die die Informationen enthält, die zum Erzeugen eines Monitors der Klasse „email/smtp“ benötig werden.

    2. Monitor erzeugen

      Anschließend wird der Monitor mit dem mci-Befehl add erzeugt.

      MonICA>mci add local\setup\monitor\email\admin.xml
      
      22
      
      MonICA>

      Der Befehl gibt die ID (22) des neu generierten Monitors aus.

  4. Monitor an Zielsystem binden

    Monitore können, ebenso wie Actions, an Tests, Hosts oder Host-Container gebunden werden. Um dem Szenario zu folgen, kann der Monitor jetzt dem Host, an den zuvor die Action gebunden wurde oder einem Container, in dem sich der Host befindet, zugeordnet werden.

    MonICA>mci map monitor 22 host fileserver.firma.de

    Das neu generierte Mapping bedeutet: monitor 22 (email/admin) wird benachrichtigt, wenn auf dem Host fileserver.firma.de ein Ereignis auftritt, für das ein Benachrichtigung konfiguriert ist..