Automap-Konfiguration

Map configuration format description

Beschreibung des Automap-Konfigurationsformats

Allgemeine Information

Das NagVis-Automap-Konfigurationsformat gleicht dem Map-Konfigurationsformat mit kleinen Unterschieden bei den verfügbaren Parametern.

Objekttypen

Beschreibung der Objekttypen

Global

Die erste Definition in jeder Konfigurationsdatei sollte vom speziellen Typ "global" sein. Optionen in diesem Paragraph gelten für die gesamte Map und werden auf andere Typen vererbt, die nachfolgend definiert werden.

Beispiel mit allen Optionen, die gesetzt werden müssen:

define global {
  map_image=lan.png
}
WertDefaultBeschreibung
aliasMap-NameDer Alias ist das Label für jede Map. Wenn definiert, wird es überall im NagVis-Frontend und WUI angezeigt
backend_idvererbt (nagvis.ini.php)Die in der Hauptkonfigurationsdatei definierte Backend-ID, die angibt, wo NagVis nach Objektzuständen suchen soll. Wenn dieser Parameter nicht angegeben wird, wird das in der Hauptkonfigurationsdatei unter "defaultbackend" angegebene Backend benutzt.
background_colorvererbt (nagvis.ini.php)Hintergrundfarbe dieser Map. Falls dieser Wert nicht gesetzt wird, wird die Hintergrundfarbe aus der Hauptkonfigurationsdatei genommen.
context_menu vererbt (nagvis.ini.php) Aktivieren/deaktivieren des Kontext-Menüs auf Ihren Map-Objekten.
context_templatevererbt (nagvis.ini.php)Default Context-Template, das auf dieser Map benutzt werden soll
default_paramsvererbt (nagvis.ini.php)zu benutzende Default-Parameter, wenn keine per URL übergeben wurden. Das Format ist wie bei dem URL, z.B. &childLayers=2. Gültige Optionen finden Sie hier. (neu in 1.5)
event_backgroundvererbt (nagvis.ini.php)Aktivieren/deaktivieren der sich ändernden Hintergrundfarbe bei Statusänderungen (die konfigurierte Farbe wird angezeigt, wenn der Gesamtstatus PENDING, OK oder UP ist).
event_highlightvererbt (nagvis.ini.php)Aktivieren/deaktivieren der Hervorhebung des sich ändernden Objekts durch eine blinkende Umrandung.
event_highlight_durationvererbt (nagvis.ini.php)Setzt die Dauer der Hervorhebung in Millisekunden.
event_highlight_intervalvererbt (nagvis.ini.php)Setzt die Dauer des Hervorhebungs-Intervalls in Millisekunden.
event_logvererbt (nagvis.ini.php)Aktivieren/deaktivieren des Eventlogs im neuen JavaScript-Backend. Das Eventlog protokolliert wichtige Aktionen und Informationen.
event_log_levelvererbt (nagvis.ini.php)Loglevel des Eventlogs (verfügbar: debug, info, warning, critical).
event_log_heightvererbt (nagvis.ini.php)Höhe des JavaScript-Eventlogs in Pixeln.
event_log_hiddenvererbt (nagvis.ini.php)Verstecken/zeigen des JavaScript-Eventlogs während des Map-Ladens.
event_scrollvererbt (nagvis.ini.php)Aktivieren/deaktivieren des Fokussierens auf das Icon, das den Zustand verändert hat, wenn dieses außerhalb des sichtbaren Bereichs ist.
event_soundvererbt (nagvis.ini.php)Aktivieren/deaktivieren von Sound-Signalen bei Statusänderungen.
header_menuvererbt (nagvis.ini.php)aktivieren/deaktivieren des Header-Menüs
header_templatevererbt (nagvis.ini.php)header template für diese Map
hover_menuvererbt (nagvis.ini.php)aktivieren/deaktivieren von Hover-Menüs
hover_delayvererbt (nagvis.ini.php)Verzögerung der Anzeige des Hover-Menus in Sekunden
hover_templatevererbt (nagvis.ini.php)Default hover template für diese Map
hover_childs_limitvererbt (nagvis.ini.php)max. Anzahl von Child-Objekten
hover_childs_ordervererbt (nagvis.ini.php)Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend)
hover_childs_showvererbt (nagvis.ini.php)Anzeigen von Child-Objekten in Hover-Menüs
hover_childs_sortvererbt (nagvis.ini.php)Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet)
iconsetvererbt (nagvis.ini.php)Iconset, das als Standard für alle auf der Map platzierten Objekte benutzt werden soll. Kann für jedes Objekt überschrieben werden.
Im Beispiel wird "std_small" benutzt, was bedeutet, dass ein OK-Zustand das Icon "std_small_ok.png", benutzt, ein CRITICAL-Zustand "std_small_critical.png" usw.
in_maintenance0aktiviert/deaktiviert den Wartungsmodus. Wenn eine Map im Wartungsmodus ist, wird statt der Map lediglich ein Hinweis angezeigt
label_show0Labelanzeige für die Map-Objekte aktivieren/deaktivieren
label_x-20x-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_y+20y-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_width auto Default-Breite der Label in Pixeln
label_backgroundtransparentDefault-Hintergrundfarbe der Label. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein.
label_border#000000Default-Rahmenfarbe der Label. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein.
label_styleBenutzerdefiniertes Aussehen des Label-Textes im Format von HTML-Style-Attributen, z.B. font-family:sans;font-weight:bold; (neu in 1.5).
line_arrowforward Dies definiert die Pfeile am Linienende. Bisher wird dieses Attribut nur für die Linien zwischen Hosts in der Automap benutzt. Mögliche Werte: forward, back, both, none (Neu in 1.5.2).
line_type Gibt den Linientyp an, wenn view_type=line. Gültige Werte sind:
"11" für Linien mit einem Pfeil am Linienende.
"10" für Linien mit zwei Pfeilen, die in der Linienmitte aufeinander zeigen.
"12" für Linien ohne Pfeil(e). (Neu in 1.5)
line_width3 Dies definiert die Linienbreite in px, wenn dieses Objekt als Linie angezeigt wird.
only_hard_statesvererbt (nagvis.ini.php)Gibt an, ob Soft-Zustände ignoriert werden sollen. Default ist 0.
recognize_servicesvererbt (nagvis.ini.php)Definiert, ob die Services des Hosts den angezeigten Status beeinflussen. Wenn auf "1" gesetzt, wird ein Service im Status CRITICAL auch den HOST als CRITICAL anzeigen. Wenn auf "0" gesetzt, wird nur der Host-Zustand (UP oder DOWN) angezeigt und der Status der Services ignoriert. Ist dieser Wert nicht in der Konfiguration angegeben, wird er auf 1 gesetzt.
show_in_listsvererbt (nagvis.ini.php)Map-Anzeige in Listenformat (Dropdowns, Indexseite, ...)
stylesheetvererbt (nagvis.ini.php)Dateiname des benutzerdefinierten Stylesheets zur Verwendung in den Maps. Die Datei muss im share/nagvis/style-Verzeichnis abgelegt sein. (neu in 1.5)
url_target _selfZiel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster)