# NagVis 1.5 Formatbeschreibung der Map-Konfiguration

## Allgemeine Informationen

Das NagVis-Konfigurationsdateiformat ist sehr ähnlich zu dem Format, das von Nagios(TM) benutzt wird.

Konfigurationsanweisungen beginnen mit dem Schlüsselwort "define" gefolgt von einem Typfeld und einer öffnenden geschweiften Klammer ({). Jede folgende Zeile definiert Variablen-Werte-Paare, getrennt durch ein Gleichheitszeichen ( = ), bis zu einer schließenden geschweiften Klammer (}).

Hashes (#) werden benutzt, um Kommentare zu markieren. Beachten Sie, dass eine Kommentarzeile mit einem Hash-Zeichen beginnen MUSS, alle anderen Zeichen (auch "Whitespaces") sind ungültig!

## Objekttypen

- global
- host
- service
- hostgroup
- servicegroup
- map
- textbox
- shape
- line (neu in 1.5)
- template

## Beschreibung der Objekttypen

### global

Die erste Definition in jeder Konfigurationsdatei sollte vom Typ "global" sein. Optionen in diesem Abschnitt gelten für die gesamte Map und werden an andere Typen vererbt, die später definiert werden.
Beispiel mit allen Optionen, die gesetzt werden müssen:

    define global {
      map_image=lan.png
    }

Wert | Default | Beschreibung
--- | --- | ---
allowed_for_config |  | Kommaseparierte Liste von Nagios-Benutzern, die diese Map editieren dürfen. EVERYONE erlaubt jedem den Zugriff (veraltet ab 1.5)
allowed_user |  | Kommaseparierte Liste von Nagios-Benutzern, die berechtigt sind, diese Maps anzusehen. EVERYONE erlaubt jedem den Zugriff (veraltet ab 1.5)
map_image |  | Das Bild, das als Hintergrund der NagVis-Map angezeigt werden soll (z.B. eine Visio (TM)-Zeichnung). Der Wert kann auch "none" oder leer sein für kein Hintergrundbild neu in 1.5: Es ist auch mölich URLs anzugeben. Diese müssen zwischen eckige Klammern [ ] gesetzt werden.
alias | Map-Name | Der Alias ist das Label für jede Map. Wenn definiert, wird es überall im NagVis-Frontend und WUI angezeigt
backend_id | vererbt (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_color | vererbt (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_template | vererbt (nagvis.ini.php) | Default Context-Template, das auf dieser Map benutzt werden soll
event_background | vererbt (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_highlight | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren der Hervorhebung des sich ändernden Objekts durch eine blinkende Umrandung.
event_log | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren des Eventlogs im neuen JavaScript-Backend. Das Eventlog protokolliert wichtige Aktionen und Informationen.
event_log_level | vererbt (nagvis.ini.php) | Loglevel des Eventlogs (verfügbar: debug, info, warning, critical).
event_log_height | vererbt (nagvis.ini.php) | Höhe des JavaScript-Eventlogs in Pixeln.
event_log_hidden | vererbt (nagvis.ini.php) | Verstecken/zeigen des JavaScript-Eventlogs während des Map-Ladens.
event_scroll | vererbt (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_sound | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren von Sound-Signalen bei Statusänderungen.
grid_color | vererbt (nagvis.ini.php) | Die Farbe der Rasterlinien (neu in 1.5)
grid_show | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren von Rasterlinien zur Ausrichtung von Objekten im WUI. Objekte werden an der linken, oberen Ecke ausgerichtet (neu in 1.5)
grid_steps | vererbt (nagvis.ini.php) | Abstand der Rasterlinien (neu in 1.5)
header_menu | vererbt (nagvis.ini.php) | aktivieren/deaktivieren des Header-Menüs
header_template | vererbt (nagvis.ini.php) | header template für diese Map
hover_menu | vererbt (nagvis.ini.php) | aktivieren/deaktivieren von Hover-Menüs
hover_delay | vererbt (nagvis.ini.php) | Verzögerung der Anzeige des Hover-Menus in Sekunden
hover_template | vererbt (nagvis.ini.php) | Default hover template für diese Map
hover_timeout | vererbt (nagvis.ini.php) | Default-Timeout (in Sekunden) bei Ajax-Abfragen in Hover-Menüs (veraltet ab 1.4)
hover_childs_limit | vererbt (nagvis.ini.php) | max. Anzahl von Child-Objekten
hover_childs_order | vererbt (nagvis.ini.php) | Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend)
hover_childs_show | vererbt (nagvis.ini.php) | Anzeigen von Child-Objekten in Hover-Menüs
hover_childs_sort | vererbt (nagvis.ini.php) | Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet)
iconset | vererbt (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_maintenance | 0 | aktiviert/deaktiviert den Wartungsmodus. Wenn eine Map im Wartungsmodus ist, wird statt der Map lediglich ein Hinweis angezeigt
label_show | 0 | Labelanzeige für die Map-Objekte aktivieren/deaktivieren
label_x | -20 | x-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_y | +20 | y-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_background | transparent | Default-Hintergrundfarbe der Label. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein.
label_border | #000000 | Default-Rahmenfarbe der Label. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein.
label_style | #000000 | Benutzerdefiniertes Aussehen des Label-Textes im Format von HTML-Style-Attributen, z.B. `font-family:sans;font-weight:bold;` (neu in 1.5).
only_hard_states | vererbt (nagvis.ini.php) | Gibt an, ob Soft-Zustände ignoriert werden sollen. Default ist 0.

recognize_services

vererbt (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_lists | vererbt (nagvis.ini.php) | Map-Anzeige in Listenformat (Dropdowns, Indexseite, ...)
stylesheet | vererbt (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 | _self | Ziel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster)
usegdlibs | vererbt (nagvis.ini.php) | Aktiviert die Benutzung der GD-Libs für diese Map (Linien können nur benutzt werden, wenn die GD-Libs aktiviert sind) (veraltet ab 1.4)

### host

Beispiel mit allen Optionen, die gesetzt werden müssen (beachten Sie, dass Optionen nicht gesetzt werden müssen, wenn sie bereits im global-Abschnitt definiert wurden):

    define host {
      host_name=localhost
      x=100
      y=200
    }

Wert | Default | Beschreibung
--- | --- | ---
host_name |  | Name des Hosts wie in Nagios definiert
x |  | X-Koordinate
y |  | Y-Koordinate
backend_id | vererbt (global) | 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.
context_menu | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren des Kontext-Menüs auf Ihren Map-Objekten.
context_template | vererbt (nagvis.ini.php) | Default Context-Template, das auf dieser Map benutzt werden soll
hover_menu | vererbt (nagvis.ini.php) | aktivieren/deaktivieren von Hover-Menüs
hover_delay | vererbt (nagvis.ini.php) | Verzögerung der Anzeige des Hover-Menus in Sekunden
hover_template | vererbt (nagvis.ini.php) | Default hover template für diese Map
hover_timeout | vererbt (nagvis.ini.php) | Default-Timeout (in Sekunden) bei Ajax-Abfragen in Hover-Menüs
hover_url |  | URL, der im Hover-Menu statt der Standard-Informationen angezeigt werden soll. Verfügbare Makros: [host_name]: Dieses Makro steht für den Objektnamen.
hover_childs_show | vererbt (nagvis.ini.php) | Anzeigen von Child-Objekten in Hover-Menüs
hover_childs_sort | vererbt (nagvis.ini.php) | Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet)
hover_childs_order | vererbt (nagvis.ini.php) | Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend)
hover_childs_limit | vererbt (nagvis.ini.php) | max. Anzahl von Child-Objekten
iconset | vererbt (global) | Spezielles Iconset. Wird vom global-Paragraph vererbt, falls es hier nicht angegeben wird.
label_show | vererbt (global) | Labelanzeige für die Map-Objekte aktivieren/deaktivieren
label_text | [name] | Text des Labels. Verfügbare Makros: [name], [output]
label_x | vererbt (global) | x-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_y | vererbt (global) | y-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_width | vererbt (global) | Breite des Labels in Pixeln
label_background | vererbt (global) | Hintergrundfarbe des Labels. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein.
label_border | vererbt (global) | Rahmenfarbe des Labels. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein.
label_style | vererbt (global) | benutzerdefiniertes Aussehen des Label-Textes im Stil von HTML-Attributen, z.B. `font-family:sans;font-weight:bold;` (neu in 1.5)
line_type |  | Gibt den Typ der Linie an, wenn view_type=line ist. Gültige Werte sind "11" für Linien mit einem Pfeil an jedem Ende "10" für Linien mit zwei Pfeilen in der Mitte der Linie, die aufeinander zeigen "12" für Linien ohne Pfeile (neu in 1.5)
line_width | 3 | Dies definiert die Breite der Linie, wenn dieses Objekt als Linie angezeigt wird.
only_hard_states | vererbt (global) | Gibt an, ob Soft-Zustände ignoriert werden sollen. Default ist 0.
recognize_services | vererbt (global) | 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.
url |  | URL, auf den das Icon verweisen soll. Default ist ein Verweis auf die Nagios-CGIs. Die Makros [host_name], [htmlcgi] und [htmlbase] sind verfügbar. Der Wert kann leer sein, um den Link zu deaktivieren.
url_target | _self | Ziel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster). Das Makro [name] ist verfügbar.
use |  | Kommaseparierte Liste von zu benutzenden Objekt-Templates. Details siehe template
view_type | icon | Diese Option definiert das Aussehen dieses Objekts. Mögliche Werte sind: "icon" oder "line". Vor NagVis 1.4 konnten Sie das Aussehen eines Objekts durch die Option line_type ändern. Seit NagVis 1.4 müssen Sie die Option view_type benutzen, um Icons als Linien anzuzeigen.
z | 1 | Die z-Option definiert die Reihenfolge, in der die Icons aufeinander gestapelt werden. Das Icon mit dem höchsten Wert wird auf der Spitze dargestellt. Das Hintergrundbild hat den Wert 0, so dass gültige Werte 1 oder größer sein müssen. Hinweis: Um Konflikte mit der Header-Navigation zu verhindern, sollte dieser Wert unter 100 bleiben.

### Service

Beispiel mit allen Optionen, die gesetzt werden müssen (beachten Sie, dass Optionen nicht gesetzt werden müssen, wenn sie bereits im global-Abschnitt definiert wurden):

    define service {
      host_name=localhost
      service_description=ping
      iconset=std_big
      x=100
      y=200
    }

Wert | Default | Beschreibung
--- | --- | ---
host_name |  | Name des Hosts wie in Nagios definiert
service_description |  | Name des Service wie in Nagios definiert
x |  | X-Koordinate
y |  | Y-Koordinate
backend_id | vererbt (global) | 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.
context_menu | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren des Kontext-Menüs auf Ihren Map-Objekten.
context_template | vererbt (nagvis.ini.php) | Default Context-Template, das auf dieser Map benutzt werden soll
gadget_url |  | Der Wert kann ein Gadget-Script im Gadget-Verzeichnis (`nagvis/gadgets`) sein, z.B. "std_speedometer.php" oder eine in Klammern gesetzte komplette URI auf ein Gadget-Script, z.B. "[http://127.0.0.1/nagvis/gadgets/std_speedometer.php]". Details zu Gadgets finden Sie hier. Diese Option wird nur erkannt, wenn view_type="gadget" gesetzt ist.
gadget_scale | 100 | Die Größe des Gadgets. Default ist 100 (Prozent). Die Gadgets sollten in der Lage sein, abhängig von diesem Parameter zu skalieren
gadget_opts |  | Optionale Gadget-spezifische Parameter. Die Inhalte können für jedes Gadget frei definiert werden. Der Wert wird als GET-Parameter "opts" verarbeitet. Wir empfehlen, ein var/val-Format zu nutzen: key1=val1,key2=val2. Dadurch können Sie diese Zeichenkette im Gadget leicht in ein Array aufteilen.
hover_menu | vererbt (nagvis.ini.php) | aktivieren/deaktivieren von Hover-Menüs
hover_template | vererbt (global) | Hover template für dieses Objekt
hover_timeout | vererbt (nagvis.ini.php) | Default-Timeout (in Sekunden) bei Ajax-Abfragen in Hover-Menüs (veraltet ab 1.4)
hover_delay | vererbt (nagvis.ini.php) | Verzögerung der Anzeige des Hover-Menus in Sekunden
hover_url |  | URL, der im Hover-Menu statt der Standard-Informationen angezeigt werden soll. Verfügbare Makros: [host_name]: Dieses Makro steht für den Objektnamen. [service_description]: Dieses Makro steht für die Service-Beschreibung und wird nur in Service-Objekten ersetzt.
hover_childs_show | vererbt (nagvis.ini.php) | Anzeigen von Child-Objekten in Hover-Menüs
hover_childs_sort | vererbt (nagvis.ini.php) | Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet)
hover_childs_order | vererbt (nagvis.ini.php) | Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend)
hover_childs_limit | vererbt (nagvis.ini.php) | max. Anzahl von Child-Objekten
iconset | vererbt (global) | Spezielles Iconset. Wird vom global-Paragraph vererbt, falls es hier nicht angegeben wird
label_show | vererbt (global) | Labelanzeige für die Map-Objekte aktivieren/deaktivieren
label_text | [name][service_description] | Text des Labels. Verfügbare Makros: [name], [service_description], [output]
label_x | vererbt (global) | x-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_y | vererbt (global) | y-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_width | vererbt (global) | Breite des Labels in Pixeln
label_background | vererbt (global) | Hintergrundfarbe des Labels. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein.
label_border | vererbt (global) | Rahmenfarbe des Labels. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein.
label_style | vererbt (global) | benutzerdefiniertes Aussehen des Label-Textes im Stil von HTML-Attributen, z.B. `font-family:sans;font-weight:bold;` (neu in 1.5)
line_type |  | Gibt den Typ der Linie an, wenn view_type=line ist. Gültige Werte sind "11" für Linien mit einem Pfeil an jedem Ende "10" für Linien mit zwei Pfeilen in der Mitte der Linie, die aufeinander zeigen "12" für Linien ohne Pfeile (neu in 1.5)
line_width | 3 | Dies definiert die Breite der Linie, wenn dieses Objekt als Linie angezeigt wird.
only_hard_states | vererbt (global) | Gibt an, ob Soft-Zustände ignoriert werden sollen. Default ist 0.
url |  | URL, auf den das Icon verweisen soll. Default ist ein Verweis auf die Nagios-CGIs. Verfügbare Makros: [host_name], [service_description], [htmlcgi] und [htmlbase]. Der Wert kann leer sein, um den Link zu deaktivieren.
url_target | _self | Ziel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster). Verfügbare Makros: [name], [service_description]
use |  | Kommaseparierte Liste von zu benutzenden Objekt-Templates. Details siehe template
view_type | icon | Diese Option definiert das Aussehen dieses Objekts. Mögliche Werte sind: "icon" oder "line". Vor NagVis 1.4 konnten Sie das Aussehen eines Objekts durch die Option line_type ändern. Seit NagVis 1.4 müssen Sie die Option view_type benutzen, um Icons als Linien anzuzeigen.
z | 1 | Die z-Option definiert die Reihenfolge, in der die Icons aufeinander gestapelt werden. Das Icon mit dem höchsten Wert wird auf der Spitze dargestellt. Das Hintergrundbild hat den Wert 0, so dass gültige Werte 1 oder größer sein müssen. Hinweis: Um Konflikte mit der Header-Navigation zu verhindern, sollte dieser Wert unter 100 bleiben.

### Hostgroup

Beispiel mit allen Optionen, die gesetzt werden müssen (beachten Sie, dass Optionen nicht gesetzt werden müssen, wenn sie bereits im global-Abschnitt definiert wurden):

    define hostgroup {
      hostgroup_name=servers
      x=100
      y=200
    }

Wert | Default | Beschreibung
--- | --- | ---
hostgroup_name |  | Name der Hostgroup wie in Nagios definiert
x |  | X-Koordinate
y |  | Y-Koordinate
backend_id | vererbt (global) | 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.
context_menu | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren des Kontext-Menüs auf Ihren Map-Objekten.
context_template | vererbt (nagvis.ini.php) | Default Context-Template, das auf dieser Map benutzt werden soll
hover_menu | vererbt (nagvis.ini.php) | aktivieren/deaktivieren von Hover-Menüs
hover_template | vererbt (global) | Hover template für dieses Objekt
hover_timeout | vererbt (nagvis.ini.php) | Default-Timeout (in Sekunden) bei Ajax-Abfragen in Hover-Menüs (veraltet ab 1.4)
hover_delay | vererbt (nagvis.ini.php) | Verzögerung der Anzeige des Hover-Menus in Sekunden
hover_url |  | URL, der im Hover-Menu statt der Standard-Informationen angezeigt werden soll. Verfügbare Makros: [hostgroup_name]: Dieses Makro steht für den Objektnamen.
hover_childs_show | vererbt (nagvis.ini.php) | Anzeigen von Child-Objekten in Hover-Menüs
hover_childs_sort | vererbt (nagvis.ini.php) | Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet)
hover_childs_order | vererbt (nagvis.ini.php) | Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend)
hover_childs_limit | vererbt (nagvis.ini.php) | max. Anzahl von Child-Objekten
iconset | vererbt (global) | Spezielles Iconset. Wird vom global-Paragraph vererbt, falls es hier nicht angegeben wird
label_show | vererbt (global) | Labelanzeige für die Map-Objekte aktivieren/deaktivieren
label_text | [name] | Text des Labels, verfügbare Makros: [name] und [output]
label_x | vererbt (global) | x-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_y | vererbt (global) | y-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_width | vererbt (global) | Breite des Labels in Pixeln
label_background | vererbt (global) | Hintergrundfarbe des Labels. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein.
label_border | vererbt (global) | Rahmenfarbe des Labels. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein.
label_style | #000000 | Benutzerdefiniertes Aussehen des Label-Textes im Format von HTML-Style-Attributen, z.B. `font-family:sans;font-weight:bold;` (neu in 1.5).
line_type |  | Gibt den Typ der Linie an, wenn view_type=line ist. Gültige Werte sind "11" für Linien mit einem Pfeil an jedem Ende "10" für Linien mit zwei Pfeilen in der Mitte der Linie, die aufeinander zeigen "12" für Linien ohne Pfeile (neu in 1.5)
line_width | 3 | Dies definiert die Breite der Linie, wenn dieses Objekt als Linie angezeigt wird.
only_hard_states | vererbt (global) | Gibt an, ob Soft-Zustände ignoriert werden sollen. Default ist 0.
recognize_services | vererbt (global) | 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.
url |  | URL, auf den das Icon verweisen soll. Default ist ein Verweis auf die Nagios-CGIs. Die Makros [hostgroup_name], [htmlcgi] und [htmlbase] sind verfügbar. Der Wert kann leer sein, um den Link zu deaktivieren.
url_target | _self | Ziel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster). Verfügbares Makro: [name]
use |  | Kommaseparierte Liste von zu benutzenden Objekt-Templates. Details siehe template
view_type | icon | Diese Option definiert das Aussehen dieses Objekts. Mögliche Werte sind: "icon" oder "line". Vor NagVis 1.4 konnten Sie das Aussehen eines Objekts durch die Option line_type ändern. Seit NagVis 1.4 müssen Sie die Option view_type benutzen, um Icons als Linien anzuzeigen.
z | 1 | Die z-Option definiert die Reihenfolge, in der die Icons aufeinander gestapelt werden. Das Icon mit dem höchsten Wert wird auf der Spitze dargestellt. Das Hintergrundbild hat den Wert 0, so dass gültige Werte 1 oder größer sein müssen. Hinweis: Um Konflikte mit der Header-Navigation zu verhindern, sollte dieser Wert unter 100 bleiben.

### Servicegroup

Beispiel mit allen Optionen, die gesetzt werden müssen (beachten Sie, dass Optionen nicht gesetzt werden müssen, wenn sie bereits im global-Abschnitt definiert wurden):

    define servicegroup {
      servicegroup_name=servicegroup1
      x=100
      y=200
    }

Wert | Default | Beschreibung
--- | --- | ---
servicegroup_name |  | Name der Servicegroup wie in Nagios definiert.
x |  | X-Koordinate
y |  | Y-Koordinate
backend_id | vererbt (global) | 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.
context_menu | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren des Kontext-Menüs auf Ihren Map-Objekten.
context_template | vererbt (nagvis.ini.php) | Default Context-Template, das auf dieser Map benutzt werden soll
hover_menu | vererbt (nagvis.ini.php) | aktivieren/deaktivieren von Hover-Menüs
hover_url |  | URL, der im Hover-Menu statt der Standard-Informationen angezeigt werden soll. Verfügbare Makros: [servicegroup_name]: Dieses Makro steht für den Objektnamen.
hover_template | vererbt (global) | Hover template für dieses Objekt
hover_timeout | vererbt (nagvis.ini.php) | Default-Timeout (in Sekunden) bei Ajax-Abfragen in Hover-Menüs (veraltet ab 1.4)
hover_delay | vererbt (nagvis.ini.php) | Verzögerung der Anzeige des Hover-Menus in Sekunden
hover_childs_show | vererbt (nagvis.ini.php) | Anzeigen von Child-Objekten in Hover-Menüs
hover_childs_sort | vererbt (nagvis.ini.php) | Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet)
hover_childs_order | vererbt (nagvis.ini.php) | Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend)
hover_childs_limit | vererbt (nagvis.ini.php) | max. Anzahl von Child-Objekten
iconset | vererbt (global) | Spezielles Iconset. Wird vom global-Paragraph vererbt, falls es hier nicht angegeben wird
label_show | vererbt (global) | Labelanzeige für die Map-Objekte aktivieren/deaktivieren
label_text | [name] | Text des Labels, verfügbare Makros: [name] und [output]
label_x | vererbt (global) | x-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_y | vererbt (global) | y-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_width | vererbt (global) | Breite des Labels in Pixeln
label_background | vererbt (global) | Hintergrundfarbe des Labels. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein.
label_border | vererbt (global) | Rahmenfarbe des Labels. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein.
label_style | #000000 | Benutzerdefiniertes Aussehen des Label-Textes im Format von HTML-Style-Attributen, z.B. `font-family:sans;font-weight:bold;` (neu in 1.5).
line_type |  | Gibt den Typ der Linie an, wenn view_type=line ist. Gültige Werte sind "11" für Linien mit einem Pfeil an jedem Ende "10" für Linien mit zwei Pfeilen in der Mitte der Linie, die aufeinander zeigen "12" für Linien ohne Pfeile (neu in 1.5)
line_width | 3 | Dies definiert die Breite der Linie, wenn dieses Objekt als Linie angezeigt wird.
only_hard_states | vererbt (global) | Gibt an, ob Soft-Zustände ignoriert werden sollen. Default ist 0.
recognize_services | vererbt (global) | 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.
url |  | URL, auf den das Icon verweisen soll. Default ist ein Verweis auf die Nagios-CGIs. Verfügbare Makros: [servicegroup_name], [htmlcgi] und [htmlbase]. Der Wert kann leer sein, um den Link zu deaktivieren.
url_target | _self | Ziel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster). Verfügbare Makros: [name].
use |  | Kommaseparierte Liste von zu benutzenden Objekt-Templates. Details siehe template
view_type | icon | Diese Option definiert das Aussehen dieses Objekts. Mögliche Werte sind: "icon" oder "line". Vor NagVis 1.4 konnten Sie das Aussehen eines Objekts durch die Option line_type ändern. Seit NagVis 1.4 müssen Sie die Option view_type benutzen, um Icons als Linien anzuzeigen.
z | 1 | Die z-Option definiert die Reihenfolge, in der die Icons aufeinander gestapelt werden. Das Icon mit dem höchsten Wert wird auf der Spitze dargestellt. Das Hintergrundbild hat den Wert 0, so dass gültige Werte 1 oder größer sein müssen. Hinweis: Um Konflikte mit der Header-Navigation zu verhindern, sollte dieser Wert unter 100 bleiben.

### Map

Beispiel mit allen Optionen, die gesetzt werden müssen (beachten Sie, dass Optionen nicht gesetzt werden müssen, wenn sie bereits im global-Abschnitt definiert wurden):

    define map {
      map_name=webserver
      x=77
      y=156
    }

Wert | Default | Beschreibung
--- | --- | ---
map_name |  | Name der Map-Konfigurationsdatei (ohne .cfg-Erweiterung)
x |  | X-Koordinate
y |  | Y-Koordinate
context_menu | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren des Kontext-Menüs auf Ihren Map-Objekten.
context_template | vererbt (nagvis.ini.php) | Default Context-Template, das auf dieser Map benutzt werden soll
hover_menu | vererbt (nagvis.ini.php) | aktivieren/deaktivieren von Hover-Menüs
hover_url |  | URL, der im Hover-Menu statt der Standard-Informationen angezeigt werden soll. Verfügbare Makros: [map_name]: Dieses Makro steht für den Objektnamen.
hover_template | vererbt (global) | Hover template für dieses Objekt
hover_delay | vererbt (nagvis.ini.php) | Verzögerung der Anzeige des Hover-Menus in Sekunden
hover_timeout | vererbt (nagvis.ini.php) | Default-Timeout (in Sekunden) bei Ajax-Abfragen in Hover-Menüs (veraltet ab 1.4)
hover_childs_show | vererbt (nagvis.ini.php) | Anzeigen von Child-Objekten in Hover-Menüs
hover_childs_sort | vererbt (nagvis.ini.php) | Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet)
hover_childs_order | vererbt (nagvis.ini.php) | Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend)
hover_childs_limit | vererbt (nagvis.ini.php) | max. Anzahl von Child-Objekten
iconset | vererbt (global) | Spezielles Iconset. Wird vom global-Paragraph vererbt, falls es hier nicht angegeben wird
label_show | vererbt (global) | Labelanzeige für die Map-Objekte aktivieren/deaktivieren
label_text | [name] | Text des Labels, verfügbare Makros: [name] und [output]
label_x | vererbt (global) | x-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_y | vererbt (global) | y-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_width | vererbt (global) | Breite des Labels in Pixeln
label_background | vererbt (global) | Hintergrundfarbe des Labels. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein.
label_border | vererbt (global) | Rahmenfarbe des Labels. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein.
label_style | #000000 | Benutzerdefiniertes Aussehen des Label-Textes im Format von HTML-Style-Attributen, z.B. `font-family:sans;font-weight:bold;` (neu in 1.5).
line_type |  | Gibt den Typ der Linie an, wenn view_type=line ist. Gültige Werte sind "11" für Linien mit einem Pfeil an jedem Ende "10" für Linien mit zwei Pfeilen in der Mitte der Linie, die aufeinander zeigen "12" für Linien ohne Pfeile (neu in 1.5)
line_width | 3 | Dies definiert die Breite der Linie, wenn dieses Objekt als Linie angezeigt wird.
only_hard_states | vererbt (global) | Gibt an, ob Soft-Zustände ignoriert werden sollen. Default ist 0.
url |  | URL, auf den das Icon verweisen soll. Default ist kein Verweis. Verfügbare Makros: [map_name], [htmlcgi] und [htmlbase]. Der Wert kann leer sein, um den Link zu deaktivieren.
url_target | _self | Ziel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster). Verfügbare Makros: [name].
use |  | Kommaseparierte Liste von zu benutzenden Objekt-Templates. Details siehe template
view_type | icon | Diese Option definiert das Aussehen dieses Objekts. Mögliche Werte sind: "icon" oder "line". Vor NagVis 1.4 konnten Sie das Aussehen eines Objekts durch die Option line_type ändern. Seit NagVis 1.4 müssen Sie die Option view_type benutzen, um Icons als Linien anzuzeigen.
z | 1 | Die z-Option definiert die Reihenfolge, in der die Icons aufeinander gestapelt werden. Das Icon mit dem höchsten Wert wird auf der Spitze dargestellt. Das Hintergrundbild hat den Wert 0, so dass gültige Werte 1 oder größer sein müssen. Hinweis: Um Konflikte mit der Header-Navigation zu verhindern, sollte dieser Wert unter 100 bleiben.

### Textbox

Beispiel mit allen möglichen Optionen:

    define textbox {
      text="This is an informational text which can be placed anywhere on the map, HTML can also be used for formatting purposes"
      x=200
      y=100
      w=200
    }

Wert | Default | Beschreibung
--- | --- | ---
text |  | Ihr eigener Text, HTML ist möglich. Es gibt die Makros [refresh_counter]: zeigt die Zeit bis zur nächsten Aktualisierung/Rotation [worker_last_run]: zeigt die Zeit des letzten "Worker-Runs"
w |  | Breite der Textbox
x |  | X-Koordinate
y |  | Y-Koordinate
background_color | #C0C0C0 | Hintergrundfarbe der Textbox. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein.
border_color | #000000 | Rahmenfarbe der Textbox. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein.
h | auto | Höhe der Textbox in px (Pixeln). "auto" bedeutet automatische Skalierung (neu in 1.5)
style | #000000 | Benutzerdefiniertes Aussehen des Textes im Format von HTML-Style-Attributen, z.B. `font-family:sans;font-weight:bold;` (neu in 1.5).
use |  | Kommaseparierte Liste von zu benutzenden Objekt-Templates. Details siehe template
z | 1 | Die z-Option definiert die Reihenfolge, in der die Icons aufeinander gestapelt werden. Das Icon mit dem höchsten Wert wird an der Spitze dargestellt. Das Hintergrundbild hat den Wert 0, so dass gültige Werte 1 oder größer sein müssen. Hinweis: Um Konflikte mit der Header-Navigation zu verhindern, sollte dieser Wert unter 100 bleiben.

### Shape

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

    define shape {
      icon="test"
      x=200
      y=100
    }

Wert | Default | Beschreibung
--- | --- | ---
Icon |  | Dateiname des Shapes. Shapes müssen im shape-Verzeichnis abgelegt werden (Default: `nagvis/images/shapes`)
x |  | X-Koordinate
y |  | Y-Koordinate
enable_refresh | 0 | Diese Option aktiviert das Shape für regelmäßige Aktualisierungen im Frontent. Dies wird nur für dynamische Shapes benötigt, die sich gelegentlich ändern.
hover_menu | 0 | Aktivieren/Deaktivieren von Hover-Menüs
hover_url |  | URL, der beim Schweben über dem Bild anzuzeigen ist. Normalerweise gibt es keine Aktion während des Schwebens.
hover_delay | vererbt (nagvis.ini.php) | Verzögerung der Anzeige des Hover-Menus in Sekunden
url |  | URL, auf den das Icon verweisen soll. Normalerweise gibt es keinen Verweis.
url_target | _self | Ziel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster)
use |  | Kommaseparierte Liste von zu benutzenden Objekt-Templates. Details siehe template
z | 1 | Die z-Option definiert die Reihenfolge, in der die Icons aufeinander gestapelt werden. Das Icon mit dem höchsten Wert wird auf der Spitze dargestellt. Das Hintergrundbild hat den Wert 0, so dass gültige Werte 1 oder größer sein müssen. Hinweis: Um Konflikte mit der Header-Navigation zu verhindern, sollte dieser Wert unter 100 bleiben.

### Line (neu in 1.5)

Die Linie ist ein statusloses Layout-Element, um Elemente zu verbinden und statuslose Verbindungen zwischen anderen Objekten darzustellen. Der Objekttyp wurde erstellt, um das Design weniger statisch zu gestalten.
Beispiel mit allen Werten, die gesetzt werden müssen:

    define line {
      line_type=1-template
      x=200
      y=100
    }

Wert | Default | Beschreibung
--- | --- | ---
line_type |  | Gibt den Typ der Linie an, wenn view_type=line ist. Gültige Werte sind "11" für Linien mit einem Pfeil an jedem Ende "10" für Linien mit zwei Pfeilen in der Mitte der Linie, die aufeinander zeigen "12" für Linien ohne Pfeile (neu in 1.5)
x |  | X-Koordinate
y |  | Y-Koordinate
hover_menu | 0 | Aktivieren/Deaktivieren von Hover-Menüs
hover_url |  | URL, der beim Schweben über dem Bild anzuzeigen ist. Normalerweise gibt es keine Aktion während des Schwebens.
hover_delay | vererbt (nagvis.ini.php) | Verzögerung der Anzeige des Hover-Menus in Sekunden
line_color | #ffffff | Die Füllfarbe der Linie, kann auch "transparent" sein.
line_color_border | #ffffff | Die Randfarbe der Linie, kann auch "transparent" sein.
line_width | 3 | Dies definiert die Breite der Linie, wenn dieses Objekt als Linie angezeigt wird.
url |  | URL, auf den das Icon verweisen soll. Normalerweise gibt es keinen Verweis.
url_target | _self | Ziel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster)
use |  | Kommaseparierte Liste von zu benutzenden Objekt-Templates. Details siehe template
z | 1 | Die z-Option definiert die Reihenfolge, in der die Icons aufeinander gestapelt werden. Das Icon mit dem höchsten Wert wird auf der Spitze dargestellt. Das Hintergrundbild hat den Wert 0, so dass gültige Werte 1 oder größer sein müssen. Hinweis: Um Konflikte mit der Header-Navigation zu verhindern, sollte dieser Wert unter 100 bleiben.

### Template

Seit Nagvis 1.2 gibt es eine neue Objektart namens `template`. Mit diesem Objekt haben Sie die Möglichkeit, alle optionalen Werte in einem Objekt zu definieren, das für viele andere gilt. Sie können alle Attribute auf die Werte setzen, die Sie benötigen und diese mit dem `use`-Attribut an andere Objekte vererben.
Zur Zeit müssen die Templates direkt in den Dateien definiert werden, weil die WUI die Definition nicht unterstützt. Wahrscheinlich wird dies in folgenden Versionen möglich sein.
Beispiel mit allen Werten, die gesetzt werden müssen:

    define template {
      name=generic-template
    }

Wert | Default | Beschreibung
--- | --- | ---
name |  | Template-Name (einfache Zeichenkette ohne Leerzeichen – muss in der Map eindeutig sein)
... |  | Alle Werte, die in den Objekten verfügbar sind, die dieses Template erben