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!

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