# NagVis 1.6 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
- 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 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_highlight_duration | vererbt (nagvis.ini.php) | Setzen der Hervorhebungsdauer in Millisekunden
event_highlight_interval | vererbt (nagvis.ini.php) | Setzen des Hervorhebungsinterall in Millisekunden
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.
exclude_members |  | Es ist möglich, member-Objekte komplett auszuschließen, während die Objektinformationen vom Backend geholt werden. Die gefilterten Elemente werden nirgendwo in diesem Objekt auftauchen. Details zur Filter-Syntax finden Sie bei der exclude regex-Definition. (Neu in 1.6b4)
exclude_member_states |  | Es ist möglich, ein oder mehrere member-Zustände während der Ermittlung des Gesamtzustands von Objekten auszuschließen. Die gefilterten Elemente werden in der member-Liste auftauchen, aber nicht für Gesamtstatusberechnungen benutzt. Details zur Filter-Syntax finden Sie bei der exclude regex-Definition. (Neu in 1.6b4)
grid_color | vererbt (nagvis.ini.php) | Die Farbe der Rasterlinien
grid_show | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren von Rasterlinien zur Ausrichtung von Objekten im WUI. Objekte werden an der linken, oberen Ecke ausgerichtet
grid_steps | vererbt (nagvis.ini.php) | Abstand der Rasterlinien
header_fade | vererbt (nagvis.ini.php) | aktivieren/deaktivieren des Abblendeffekts in den Untermenüs des Header-Menüs (wenn das verwendete Header-Menü diese Option unterstützt).
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_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)
hover_delay | vererbt (nagvis.ini.php) | Verzögerung der Anzeige des Hover-Menus in Sekunden
hover_menu | vererbt (nagvis.ini.php) | aktivieren/deaktivieren von Hover-Menüs
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)
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;`.
line_arrow | forward | Dies defniert 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.
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).
line_width | 3 | Dies definiert die Linienbreite in px, wenn dieses Objekt als Linie angezeigt wird.
line_weather_colors | 10:#8c00ff,25:#2020ff,40:#00c0ff,55:#00f000,70:#f0f000,85:#ffc000,100:#ff0000 | Dies definiert die Farben von Wetterkarten-Farben in den unterschiedlichen Prozentstufen. Über 10% wird z.B. #8c00ff als Farbe benutzt. (Neu in 1.6)
only_hard_states | vererbt (nagvis.ini.php) | Gibt an, ob Soft-Zustände ignoriert werden sollen. Default ist 0.
parent_map |  | Die Eltern-Map dieser Karte. Die Option wird nur bei den Menü-Visualisierungen des Header-Menüs und der Sidebar benutzt (Neu in 1.6)
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, ...)
show_in_multisite | vererbt (nagvis.ini.php) | Zeigen der Maps im Multisite-Snapin
stylesheet | vererbt (nagvis.ini.php) | Dateiname des benutzerdefinierten Stylesheets zur Verwendung in den Maps. Die Datei muss im share/nagvis/style-Verzeichnis abgelegt sein.
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
--- | --- | ---
object_id |  | Eindeutiger Bezeichner des Objekts auf der aktuellen Map. Jedes Objekt der Map benötigt eine object_id. Die object_id besteht aus alphanumerischen Zeichen beliebiger Länge. Wenn keine object_id angegeben ist, wird NagVis für das Objekt eine erzeugen (neu in 1.6)
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
exclude_members |  | Es ist möglich, member-Objekte komplett auszuschließen, während die Objektinformationen vom Backend geholt werden. Die gefilterten Elemente werden nirgendwo in diesem Objekt auftauchen. Details zur Filter-Syntax finden Sie bei der exclude regex-Definition. (Neu in 1.6b4)
exclude_member_states |  | Es ist möglich, ein oder mehrere member-Zustände während der Ermittlung des Gesamtzustands von Objekten auszuschließen. Die gefilterten Elemente werden in der member-Liste auftauchen, aber nicht für Gesamtstatusberechnungen benutzt. Details zur Filter-Syntax finden Sie bei der exclude regex-Definition. (Neu in 1.6b4)
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;`
line_arrow | vererbt (global) | 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.
line_type | vererbt (global) | 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
line_width | vererbt (global) | 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
--- | --- | ---
object_id |  | Eindeutiger Bezeichner des Objekts auf der aktuellen Map. Jedes Objekt der Map benötigt eine object_id. Die object_id besteht aus alphanumerischen Zeichen beliebiger Länge. Wenn keine object_id angegeben ist, wird NagVis für das Objekt eine erzeugen (neu in 1.6)
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
exclude_members |  | Es ist möglich, member-Objekte komplett auszuschließen, während die Objektinformationen vom Backend geholt werden. Die gefilterten Elemente werden nirgendwo in diesem Objekt auftauchen. Details zur Filter-Syntax finden Sie bei der exclude regex-Definition. (Neu in 1.6b4)
exclude_member_states |  | Es ist möglich, ein oder mehrere member-Zustände während der Ermittlung des Gesamtzustands von Objekten auszuschließen. Die gefilterten Elemente werden in der member-Liste auftauchen, aber nicht für Gesamtstatusberechnungen benutzt. Details zur Filter-Syntax finden Sie bei der exclude regex-Definition. (Neu in 1.6b4)
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;`
line_arrow | vererbt (global) | 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.
line_cut | 0.5 | Linien mit zwei Teilen haben den Schnitt in der Mitte der Linie. Dies entspricht einem "line_cut"-Wert von "0.5". Es ist möglich, den Schnitt durch Veränderung des Wertes zu verschieben. Gültige Werte sind 0.0 bis 1.0.
line_label_pos_in | 0.5 | Bei Wetterkarten-Linien sind die Bezeichnungen normalerweise in der Mitte der Linie. Dies entspricht einem Wert von "0.5". Es ist möglich, die Platzierung durch diesen Werte zu verschieben. Gültige Werte liegen zwischen 0.0 to 1.0.
line_label_pos_out | 0.5 | Bei Wetterkarten-Linien sind die Bezeichnungen normalerweise in der Mitte der Linie. Dies entspricht einem Wert von "0.5". Es ist möglich, die Platzierung durch diesen Werte zu verschieben. Gültige Werte liegen zwischen 0.0 to 1.0.
line_label_y_offset | 2 | Diese Option definiert den Abstand der Bezeichnungen zur Linie beim Rendern von Wetterkarten-Linien, die Prozent- und absolute Bandbreitendaten anzeigen. (Neu in 1.6)
line_weather_colors | vererbt (global) | Dies definiert die Farben von Wetterkarten-Farben in den unterschiedlichen Prozentstufen. Über 10% wird z.B. #8c00ff als Farbe benutzt. (Neu in 1.6)
line_type | vererbt (global) | 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
line_width | vererbt (global) | 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
--- | --- | ---
object_id |  | Eindeutiger Bezeichner des Objekts auf der aktuellen Map. Jedes Objekt der Map benötigt eine object_id. Die object_id besteht aus alphanumerischen Zeichen beliebiger Länge. Wenn keine object_id angegeben ist, wird NagVis für das Objekt eine erzeugen (neu in 1.6)
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
exclude_members |  | Es ist möglich, member-Objekte komplett auszuschließen, während die Objektinformationen vom Backend geholt werden. Die gefilterten Elemente werden nirgendwo in diesem Objekt auftauchen. Details zur Filter-Syntax finden Sie bei der exclude regex-Definition. (Neu in 1.6b4)
exclude_member_states |  | Es ist möglich, ein oder mehrere member-Zustände während der Ermittlung des Gesamtzustands von Objekten auszuschließen. Die gefilterten Elemente werden in der member-Liste auftauchen, aber nicht für Gesamtstatusberechnungen benutzt. Details zur Filter-Syntax finden Sie bei der exclude regex-Definition. (Neu in 1.6b4)
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 | vererbt (global) | Benutzerdefiniertes Aussehen des Label-Textes im Format von HTML-Style-Attributen, z.B. `font-family:sans;font-weight:bold;`.
line_arrow | vererbt (global) | 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.
line_type | vererbt (global) | 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
line_width | vererbt (global) | Dies definiert die Breite der Linie, wenn dieses Objekt als Linie angezeigt wird.
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
--- | --- | ---
object_id |  | Eindeutiger Bezeichner des Objekts auf der aktuellen Map. Jedes Objekt der Map benötigt eine object_id. Die object_id besteht aus alphanumerischen Zeichen beliebiger Länge. Wenn keine object_id angegeben ist, wird NagVis für das Objekt eine erzeugen (neu in 1.6)
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
exclude_members |  | Es ist möglich, member-Objekte komplett auszuschließen, während die Objektinformationen vom Backend geholt werden. Die gefilterten Elemente werden nirgendwo in diesem Objekt auftauchen. Details zur Filter-Syntax finden Sie bei der exclude regex-Definition. (Neu in 1.6b4)
exclude_member_states |  | Es ist möglich, ein oder mehrere member-Zustände während der Ermittlung des Gesamtzustands von Objekten auszuschließen. Die gefilterten Elemente werden in der member-Liste auftauchen, aber nicht für Gesamtstatusberechnungen benutzt. Details zur Filter-Syntax finden Sie bei der exclude regex-Definition. (Neu in 1.6b4)
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 | vererbt (global) | Benutzerdefiniertes Aussehen des Label-Textes im Format von HTML-Style-Attributen, z.B. `font-family:sans;font-weight:bold;`.
line_arrow | vererbt (global) | 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.
line_type | vererbt (global) | 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
line_width | vererbt (global) | 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: [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
--- | --- | ---
object_id |  | Eindeutiger Bezeichner des Objekts auf der aktuellen Map. Jedes Objekt der Map benötigt eine object_id. Die object_id besteht aus alphanumerischen Zeichen beliebiger Länge. Wenn keine object_id angegeben ist, wird NagVis für das Objekt eine erzeugen (neu in 1.6)
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
exclude_members |  | Es ist möglich, member-Objekte komplett auszuschließen, während die Objektinformationen vom Backend geholt werden. Die gefilterten Elemente werden nirgendwo in diesem Objekt auftauchen. Details zur Filter-Syntax finden Sie bei der exclude regex-Definition. (Neu in 1.6b4)
exclude_member_states |  | Es ist möglich, ein oder mehrere member-Zustände während der Ermittlung des Gesamtzustands von Objekten auszuschließen. Die gefilterten Elemente werden in der member-Liste auftauchen, aber nicht für Gesamtstatusberechnungen benutzt. Details zur Filter-Syntax finden Sie bei der exclude regex-Definition. (Neu in 1.6b4)
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 | vererbt (global) | Benutzerdefiniertes Aussehen des Label-Textes im Format von HTML-Style-Attributen, z.B. `font-family:sans;font-weight:bold;`.
line_arrow | vererbt (global) | 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.
line_type | vererbt (global) | 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
line_width | vererbt (global) | 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
--- | --- | ---
object_id |  | Eindeutiger Bezeichner des Objekts auf der aktuellen Map. Jedes Objekt der Map benötigt eine object_id. Die object_id besteht aus alphanumerischen Zeichen beliebiger Länge. Wenn keine object_id angegeben ist, wird NagVis für das Objekt eine erzeugen (neu in 1.6)
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"
x |  | X-Koordinate
y |  | Y-Koordinate
w | auto | Breite der Textbox in px (Pixeln). "auto" bedeutet automatische Skalierung
h | auto | Höhe der Textbox in px (Pixeln). "auto" bedeutet automatische Skalierung
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.
style | #000000 | Benutzerdefiniertes Aussehen des Textes im Format von HTML-Style-Attributen, z.B. `font-family:sans;font-weight:bold;`.
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
--- | --- | ---
object_id |  | Eindeutiger Bezeichner des Objekts auf der aktuellen Map. Jedes Objekt der Map benötigt eine object_id. Die object_id besteht aus alphanumerischen Zeichen beliebiger Länge. Wenn keine object_id angegeben ist, wird NagVis für das Objekt eine erzeugen (neu in 1.6)
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

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
          x=200
          y=100
        }

Wert | Default | Beschreibung
--- | --- | ---
object_id |  | Eindeutiger Bezeichner des Objekts auf der aktuellen Map. Jedes Objekt der Map benötigt eine object_id. Die object_id besteht aus alphanumerischen Zeichen beliebiger Länge. Wenn keine object_id angegeben ist, wird NagVis für das Objekt eine erzeugen (neu in 1.6)
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
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_arrow | vererbt (global) | 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.
line_color | #ffffff | Die Füllfarbe der Linie, kann auch "transparent" sein.
line_color_border | #000000 | Die Randfarbe der Linie, kann auch "transparent" sein.
line_width | vererbt (global) | 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