Automap

Einleitung

Die NagVis-Automap wurde mit NagVis-1.3 eingeführt. Die Hauptaufgabe dieses Features ist der Ersatz der eingebauten Map von Nagios. Das größte Problem der Nagios-Map ist die fehlende Skalierbarkeit. In großen Nagios-Installationen ist die Automap nicht nutzbar. Das liegt u.a. an fehlenden Konfigurationsoptionen wie z.B. der Selektion von bestimmten anzuzeigenden Elementen.

NagVis behandelt die Objekte und definiert eine Konfiguration für Graphviz. Das Map-Bild und der HTML-Code für die Links werden von GraphViz erzeugt und an NagVis weitergeleitet.

Voraussetzungen

Erster Aufruf

Wenn Sie bisher keine Erfahrung mit der Automap haben, dann werfen Sie einen Blick auf die Demo-Automaps, die mit NagVis installiert werden (demo-automap und demo-automap2). Sie sollten in der Lage sein, diese Automaps direkt nach der NagVis-Installation über das "Öffnen"-Menü in der Kopfzeile zu öffnen. Wenn alles korrekt konfiguriert ist, sollten auf der Demonstrations-Map "demo-automap" der root-Host und drei Ebenen von Kind-Hosts angezeigt werden.

Map-Konfiguration

In der Vergangenheit wurden die Automaps durch spezielle Map-Konfigurationsdateien konfiguriert, die im Verzeichnis etc/automaps abgelegt waren, aber dies wurde mit NagVis 1.7 geändert. Die Automap-Konfigurationsdateien werden nun wie normale Map-Konfigurationen erzeugt (wie in Map-Konfigurationsdatei beschrieben. Um ab NagVis 1.7 eine Automap zu erzeugen, müssen Sie die Map-Source auf automap setzen. Um dies zu tun, müssen Sie im global-Abschnitt den sources-Parameter einfügen und ihm den Wert automap geben.

Hauptkonfiguration

Einige Parameter für die Automap können in der Hauptkonfiguration von NagVis gesetzt werden. Weitere Informationen finden Sie in der Beschreibung der Hauptkonfigurationsdatei.

URL-Parameter

Die Automap kann mit verschiedenen URL-Parametern aufgerufen werden. Seit NagVis 1.7 können diese Optionen in den global-Abschnitt der Map-Konfiguration eingetragen werden, damit sie persistent sind. Hier eine Liste aller verfügbarer Optionen:
LR
Parameter Default Beschreibung
show Der Name der Automap. Seit NagVis 1.5 können verschiedene Automap-Konfigurationsdateien definiert werden. Die anzuzeigende Automap muss hier angegeben werden.
backend_id backend default backend Die Backend-Id des Backends, dessen Objekte benutzt werden sollen. Einzelheiten finden Sie im [backend_*]-Abschnitt der Beschreibung der Hauptkonfigurationsdatei.
root siehe root object definitionDies ist der Name des Root-Objektes. Es ist nicht notwendig, den Host hier zu setzen. Es gibt mehrere Wege, das Root-Objekt zu ermitteln. Einzelheiten finden Sie im Root-Objekt-Definition-Kapitel auf dieser Seite
child_layers childLayers 2 maximale Anzahl von anzuzeigenden Ebenen abhängiger "Child"-Hosts.
parent_layers parentLayers 0 maximale Anzahl von anzuzeigenden Ebenen darüber liegender "Parent"-Hosts.
render_mode renderMode undirected Setzt den Render-Modus der Map. Einzelheiten finden Sie unter verfügbare Render-Modi
width 1024 Breite der Automap in Pixeln
height 786 Höhe der Automap in Pixeln
ignore_hosts ignoreHosts none Kommaseparierte Liste von Hosts (einschließlich abhängiger Hosts), die nicht angezeigt werden sollen
filter_by_state filterByState none Bei einem Wert von 1 ist der "Problem Automap"-Modus aktiviert. Dabei werden alle Zweige ausgefiltert, die nur Hosts im Status "UP" enthalten. Das resultiert in einer "Problem-Automap", die einen Baum zeigt, in dem in jedem Zweig mindestens einen Host mit einem Problem gibt
filter_by_id Die angegebenen object_ids ausschließen; wird hauptsächlich intern genutzt .
filter_group filterGroup none Geben Sie den Namen einer Hostgruppe an. Nur Hosts dieser Hostgruppe werden auf der Map angezeigt.
search none Suche nach einem Map-Objekt während des Map-Ladens. Passende Objekte werden hervorgehoben.
rankdir none Konfiguriert die Richtung von gerichteten Automaps, kann auf TB (Top/Bottom) oder LR (Links/Rechts) gesetzt werden.
rotation none Rotieren der Map-Objekte im angegebenen Rotations-Pool
header_menu enableHeader none Aktivieren/Deaktivieren des Header-Menüs durch 1 bzw. 0. Übersteuert die Konfiguration.
hover_menu enableHover none Aktivieren/Deaktivieren des Hover-Menüs durch 1 bzw. 0. Übersteuert die Konfiguration.
context_menu enableContext none Aktivieren/Deaktivieren des Context-Menüs durch 1 bzw. 0. Übersteuert die Konfiguration.
margin none Setzt den freien Bereich am Rand des Automap-Graphen. Die Angabe erfolgt in Pixeln.
overlap none Konfigurieren der Kollisionsbehandlung von Objekten (eine Erklärung der Werte finden Sie in der GraphViz-Dokumentation)

Root-Objekt-Definition

Die Vorgehensweise der Automap ist, beim Root-Objekt zu beginnen und den in Nagios definierten Abhängigkeitsbaum zu durchlaufen und die gefundenen Objekte auf der Map anzuzeigen.
Es gibt mehrere Wege, um das Root-Objekt zu ermitteln: Die obige Liste ist nach Priorität geordnet.

Verfügbare Render-Modi

Es gibt verschiedene verfügbare Render-Modi:
Modus Beispiel-Bild
directed
undirected
radial
circular
undirected2

Automap-nach-Map-Export

Seit NagVis 1.5 ist es möglich, die aktuelle Automap-Ansicht als normale NagVis-Map zu exportieren. Durch den Export erhalten Sie Vorteile aus beiden Ansichten.

Sie können mit der Automap beginnen, um mit Hilfe der Automap-Render-Modi die Objekte auf Ihrer Automap zu positionieren. Sobald Sie fertig sind, exportieren Sie die Automap zusammen mit dem generierten Hintergrundbild in eine reguläre Map. Dazu benutzen Sie den Punkt "Export to map", den Sie im "Aktionen"-Menü Ihres Header-Menüs finden.

Auf der exportierten Map können Sie - abhängig von Ihren Anforderungen - zusätzliche Design-Elemente platzieren oder das Layout anpassen.

Eine Automap kann beliebig oft in die gleiche Ziel-Map exportiert werden (wodurch natürlich Ihre Anpassungen in der Ziel-Map überschrieben werden!). Sie können nur Maps überschreiben, wenn Sie die Berechtigung dazu haben.

Eine normale Map kann nicht in eine Automap konvertiert werden.

Host-URLs

Die URLs von Host-Objekten werden zur Identifizierung der Objekte während des Renderns benutzt. Speziell der "host="-Parameter ist wichtig. Wenn dieser Parameter in der Host-URL fehlt, dann können die Objektpositionen nicht ermittelt werden.

Normalerweise sollte diese Information nicht von Interesse für Sie sein. Wenn Sie aber die Host-URLs in Ihrer NagVis-Installation anpassen, dann ist es wichtig zu wissen, dass Ihre benutzerdefinierte URL den Parameter "host=" enthalten muss, der mit dem Hostnamen des Objekts zu füllen ist, damit die Hosts in der Automap benutzt werden können.