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!
define global { map_image=lan.png }
Wert | Default | Beschreibung |
---|---|---|
map_image | Das Bild, das als Hintergrund der NagVis-Map angezeigt werden soll (z.B. eine Visio (TM)-Zeichnung). Der Wert kann auch "none" oder leer sein für kein Hintergrundbild neu in 1.5: Es ist auch mölich URLs anzugeben. Diese müssen zwischen eckige Klammern [ ] gesetzt werden. |
|
alias | Map-Name | Der Alias ist das Label für jede Map. Wenn definiert, wird es überall im NagVis-Frontend und WUI angezeigt |
backend_id | vererbt (nagvis.ini.php) | Die in der Hauptkonfigurationsdatei definierte Backend-ID, die angibt, wo NagVis nach Objektzuständen suchen soll. Wenn dieser Parameter nicht angegeben wird, wird das in der Hauptkonfigurationsdatei unter "defaultbackend" angegebene Backend benutzt. |
background_color | vererbt (nagvis.ini.php) | Hintergrundfarbe dieser Map. Falls dieser Wert nicht gesetzt wird, wird die Hintergrundfarbe aus der Hauptkonfigurationsdatei genommen. |
context_menu | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren des Kontext-Menüs auf Ihren Map-Objekten. |
context_template | vererbt (nagvis.ini.php) | Default Context-Template, das auf dieser Map benutzt werden soll |
event_background | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren der sich ändernden Hintergrundfarbe bei Statusänderungen (die konfigurierte Farbe wird angezeigt, wenn der Gesamtstatus PENDING, OK oder UP ist). |
event_highlight | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren der Hervorhebung des sich ändernden Objekts durch eine blinkende Umrandung. |
event_log | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren des Eventlogs im neuen JavaScript-Backend. Das Eventlog protokolliert wichtige Aktionen und Informationen. |
event_log_level | vererbt (nagvis.ini.php) | Loglevel des Eventlogs (verfügbar: debug, info, warning, critical). |
event_log_height | vererbt (nagvis.ini.php) | Höhe des JavaScript-Eventlogs in Pixeln. |
event_log_hidden | vererbt (nagvis.ini.php) | Verstecken/zeigen des JavaScript-Eventlogs während des Map-Ladens. |
event_scroll | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren des Fokussierens auf das Icon, das den Zustand verändert hat, wenn dieses außerhalb des sichtbaren Bereichs ist. |
event_sound | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren von Sound-Signalen bei Statusänderungen. |
grid_color | vererbt (nagvis.ini.php) | Die Farbe der Rasterlinien (neu in 1.5) |
grid_show | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren von Rasterlinien zur Ausrichtung von Objekten im WUI. Objekte werden an der linken, oberen Ecke ausgerichtet (neu in 1.5) |
grid_steps | vererbt (nagvis.ini.php) | Abstand der Rasterlinien (neu in 1.5) |
header_menu | vererbt (nagvis.ini.php) | aktivieren/deaktivieren des Header-Menüs |
header_template | vererbt (nagvis.ini.php) | header template für diese Map |
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). (Neu in 1.5.2) |
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_childs_limit | vererbt (nagvis.ini.php) | max. Anzahl von Child-Objekten |
hover_childs_order | vererbt (nagvis.ini.php) | Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend) |
hover_childs_show | vererbt (nagvis.ini.php) | Anzeigen von Child-Objekten in Hover-Menüs |
hover_childs_sort | vererbt (nagvis.ini.php) | Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet) |
iconset | vererbt (nagvis.ini.php) | Iconset, das als Standard für alle auf der Map platzierten Objekte benutzt werden soll. Kann für jedes Objekt überschrieben werden. Im Beispiel wird "std_small" benutzt, was bedeutet, dass ein OK-Zustand das Icon "std_small_ok.png", benutzt, ein CRITICAL-Zustand "std_small_critical.png" usw. |
in_maintenance | 0 | aktiviert/deaktiviert den Wartungsmodus. Wenn eine Map im Wartungsmodus ist, wird statt der Map lediglich ein Hinweis angezeigt |
label_show | 0 | Labelanzeige für die Map-Objekte aktivieren/deaktivieren |
label_x | -20 | x-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position) |
label_y | +20 | y-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position) |
label_width | auto | Default-Breite der Label in Pixeln |
label_background | transparent | Default-Hintergrundfarbe der Label. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein. |
label_border | #000000 | Default-Rahmenfarbe der Label. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein. |
label_style | #000000 | Benutzerdefiniertes Aussehen des Label-Textes im Format von HTML-Style-Attributen, z.B. font-family:sans;font-weight:bold; (neu in 1.5). |
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 (Neu in 1.5.2). |
line_type | Gibt den Linientyp an, wenn view_type=line. Gültige Werte sind: "11" für Linien mit einem Pfeil am Linienende. "10" für Linien mit zwei Pfeilen, die in der Linienmitte aufeinander zeigen. "12" für Linien ohne Pfeil(e). (Neu in 1.5) |
|
line_width | 3 | Dies definiert die Linienbreite in px, wenn dieses Objekt als Linie angezeigt wird. |
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, ...) |
stylesheet | vererbt (nagvis.ini.php) | Dateiname des benutzerdefinierten Stylesheets zur Verwendung in den Maps. Die Datei muss im share/nagvis/style-Verzeichnis abgelegt sein. (neu in 1.5) |
url_target | _self | Ziel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster) |
define host { host_name=localhost x=100 y=200 }
Wert | Default | Beschreibung |
---|---|---|
host_name | Name des Hosts wie in Nagios definiert | |
x | X-Koordinate | |
y | Y-Koordinate | |
backend_id | vererbt (global) | Die in der Hauptkonfigurationsdatei definierte Backend-ID, die angibt, wo NagVis nach Objektzuständen suchen soll. Wenn dieser Parameter nicht angegeben wird, wird das in der Hauptkonfigurationsdatei unter "defaultbackend" angegebene Backend benutzt. |
context_menu | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren des Kontext-Menüs auf Ihren Map-Objekten. |
context_template | vererbt (nagvis.ini.php) | Default Context-Template, das auf dieser Map benutzt werden soll |
hover_menu | vererbt (nagvis.ini.php) | aktivieren/deaktivieren von Hover-Menüs |
hover_delay | vererbt (nagvis.ini.php) | Verzögerung der Anzeige des Hover-Menus in Sekunden |
hover_template | vererbt (nagvis.ini.php) | Default hover template für diese Map |
hover_url | URL, der im Hover-Menu statt der Standard-Informationen angezeigt werden soll. Verfügbare Makros: [host_name]: Dieses Makro steht für den Objektnamen. |
|
hover_childs_show | vererbt (nagvis.ini.php) | Anzeigen von Child-Objekten in Hover-Menüs |
hover_childs_sort | vererbt (nagvis.ini.php) | Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet) |
hover_childs_order | vererbt (nagvis.ini.php) | Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend) |
hover_childs_limit | vererbt (nagvis.ini.php) | max. Anzahl von Child-Objekten |
iconset | vererbt (global) | Spezielles Iconset. Wird vom global-Paragraph vererbt, falls es hier nicht angegeben wird. |
label_show | vererbt (global) | Labelanzeige für die Map-Objekte aktivieren/deaktivieren |
label_text | [name] | Text des Labels. Verfügbare Makros: [name], [output] |
label_x | vererbt (global) | x-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position) |
label_y | vererbt (global) | y-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position) |
label_width | vererbt (global) | Breite des Labels in Pixeln |
label_background | vererbt (global) | Hintergrundfarbe des Labels. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein. |
label_border | vererbt (global) | Rahmenfarbe des Labels. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein. |
label_style | vererbt (global) | benutzerdefiniertes Aussehen des Label-Textes im Stil von HTML-Attributen, z.B. font-family:sans;font-weight:bold; (neu in 1.5) |
line_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 (Neu in 1.5.2). |
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 (neu in 1.5) |
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. |
define service { host_name=localhost service_description=ping iconset=std_big x=100 y=200 }
Wert | Default | Beschreibung |
---|---|---|
host_name | Name des Hosts wie in Nagios definiert | |
service_description | Name des Service wie in Nagios definiert | |
x | X-Koordinate | |
y | Y-Koordinate | |
backend_id | vererbt (global) | Die in der Hauptkonfigurationsdatei definierte Backend-ID, die angibt, wo NagVis nach Objektzuständen suchen soll. Wenn dieser Parameter nicht angegeben wird, wird das in der Hauptkonfigurationsdatei unter "defaultbackend" angegebene Backend benutzt. |
context_menu | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren des Kontext-Menüs auf Ihren Map-Objekten. |
context_template | vererbt (nagvis.ini.php) | Default Context-Template, das auf dieser Map benutzt werden soll |
gadget_url | Der Wert kann ein Gadget-Script im Gadget-Verzeichnis (nagvis/gadgets ) sein, z.B. "std_speedometer.php" oder eine in Klammern gesetzte komplette URI auf ein Gadget-Script, z.B. "[http://127.0.0.1/nagvis/gadgets/std_speedometer.php]". Details zu Gadgets finden Sie hier. Diese Option wird nur erkannt, wenn view_type="gadget" gesetzt ist. |
|
gadget_scale | 100 | Die Größe des Gadgets. Default ist 100 (Prozent). Die Gadgets sollten in der Lage sein, abhängig von diesem Parameter zu skalieren |
gadget_opts | Optionale Gadget-spezifische Parameter. Die Inhalte können für jedes Gadget frei definiert werden. Der Wert wird als GET-Parameter "opts" verarbeitet. Wir empfehlen, ein var/val-Format zu nutzen: key1=val1,key2=val2. Dadurch können Sie diese Zeichenkette im Gadget leicht in ein Array aufteilen. | hover_menu | vererbt (nagvis.ini.php) | aktivieren/deaktivieren von Hover-Menüs |
hover_template | vererbt (global) | Hover template für dieses Objekt |
hover_delay | vererbt (nagvis.ini.php) | Verzögerung der Anzeige des Hover-Menus in Sekunden |
hover_url | URL, der im Hover-Menu statt der Standard-Informationen angezeigt werden soll. Verfügbare Makros: [host_name]: Dieses Makro steht für den Objektnamen. [service_description]: Dieses Makro steht für die Service-Beschreibung und wird nur in Service-Objekten ersetzt. |
|
hover_childs_show | vererbt (nagvis.ini.php) | Anzeigen von Child-Objekten in Hover-Menüs |
hover_childs_sort | vererbt (nagvis.ini.php) | Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet) |
hover_childs_order | vererbt (nagvis.ini.php) | Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend) |
hover_childs_limit | vererbt (nagvis.ini.php) | max. Anzahl von Child-Objekten |
iconset | vererbt (global) | Spezielles Iconset. Wird vom global-Paragraph vererbt, falls es hier nicht angegeben wird |
label_show | vererbt (global) | Labelanzeige für die Map-Objekte aktivieren/deaktivieren |
label_text | [name][service_description] | Text des Labels. Verfügbare Makros: [name], [service_description], [output] |
label_x | vererbt (global) | x-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position) |
label_y | vererbt (global) | y-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position) |
label_width | vererbt (global) | Breite des Labels in Pixeln |
label_background | vererbt (global) | Hintergrundfarbe des Labels. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein. |
label_border | vererbt (global) | Rahmenfarbe des Labels. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein. |
label_style | vererbt (global) | benutzerdefiniertes Aussehen des Label-Textes im Stil von HTML-Attributen, z.B. font-family:sans;font-weight:bold; (neu in 1.5) |
line_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 (Neu in 1.5.2). |
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. (Neu in 1.5.2) |
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 (neu in 1.5) |
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. |
define hostgroup { hostgroup_name=servers x=100 y=200 }
Wert | Default | Beschreibung |
---|---|---|
hostgroup_name | Name der Hostgroup wie in Nagios definiert | |
x | X-Koordinate | |
y | Y-Koordinate | |
backend_id | vererbt (global) | Die in der Hauptkonfigurationsdatei definierte Backend-ID, die angibt, wo NagVis nach Objektzuständen suchen soll. Wenn dieser Parameter nicht angegeben wird, wird das in der Hauptkonfigurationsdatei unter "defaultbackend" angegebene Backend benutzt. |
context_menu | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren des Kontext-Menüs auf Ihren Map-Objekten. |
context_template | vererbt (nagvis.ini.php) | Default Context-Template, das auf dieser Map benutzt werden soll |
hover_menu | vererbt (nagvis.ini.php) | aktivieren/deaktivieren von Hover-Menüs |
hover_template | vererbt (global) | Hover template für dieses Objekt |
hover_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; (neu in 1.5). |
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 (Neu in 1.5.2). |
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 (neu in 1.5) |
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 [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. |
define servicegroup { servicegroup_name=servicegroup1 x=100 y=200 }
Wert | Default | Beschreibung |
---|---|---|
servicegroup_name | Name der Servicegroup wie in Nagios definiert. | |
x | X-Koordinate | |
y | Y-Koordinate | |
backend_id | vererbt (global) | Die in der Hauptkonfigurationsdatei definierte Backend-ID, die angibt, wo NagVis nach Objektzuständen suchen soll. Wenn dieser Parameter nicht angegeben wird, wird das in der Hauptkonfigurationsdatei unter "defaultbackend" angegebene Backend benutzt. |
context_menu | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren des Kontext-Menüs auf Ihren Map-Objekten. |
context_template | vererbt (nagvis.ini.php) | Default Context-Template, das auf dieser Map benutzt werden soll |
hover_menu | vererbt (nagvis.ini.php) | aktivieren/deaktivieren von Hover-Menüs |
hover_url | URL, der im Hover-Menu statt der Standard-Informationen angezeigt werden soll. Verfügbare Makros: [servicegroup_name]: Dieses Makro steht für den Objektnamen. |
|
hover_template | vererbt (global) | Hover template für dieses Objekt |
hover_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; (neu in 1.5). |
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 (Neu in 1.5.2). |
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 (neu in 1.5) |
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. 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. |
define map { map_name=webserver x=77 y=156 }
Wert | Default | Beschreibung |
---|---|---|
map_name | Name der Map-Konfigurationsdatei (ohne .cfg-Erweiterung) | |
x | X-Koordinate | |
y | Y-Koordinate | |
context_menu | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren des Kontext-Menüs auf Ihren Map-Objekten. |
context_template | vererbt (nagvis.ini.php) | Default Context-Template, das auf dieser Map benutzt werden soll |
hover_menu | vererbt (nagvis.ini.php) | aktivieren/deaktivieren von Hover-Menüs |
hover_url | URL, der im Hover-Menu statt der Standard-Informationen angezeigt werden soll. Verfügbare Makros: [map_name]: Dieses Makro steht für den Objektnamen. |
|
hover_template | vererbt (global) | Hover template für dieses Objekt |
hover_delay | vererbt (nagvis.ini.php) | Verzögerung der Anzeige des Hover-Menus in Sekunden |
hover_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; (neu in 1.5). |
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 (Neu in 1.5.2). |
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 (neu in 1.5) |
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. |
define textbox { text="This is an informational text which can be placed anywhere on the map, HTML can also be used for formatting purposes" x=200 y=100 w=200 }
Wert | Default | Beschreibung |
---|---|---|
text | Ihr eigener Text, HTML ist möglich. Es gibt die Makros [refresh_counter]: zeigt die Zeit bis zur nächsten Aktualisierung/Rotation [worker_last_run]: zeigt die Zeit des letzten "Worker-Runs" |
|
w | Breite der Textbox | |
x | X-Koordinate | |
y | Y-Koordinate | |
background_color | #C0C0C0 | Hintergrundfarbe der Textbox. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein. |
border_color | #000000 | Rahmenfarbe der Textbox. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein. |
h | auto | Höhe der Textbox in px (Pixeln). "auto" bedeutet automatische Skalierung (neu in 1.5) |
style | #000000 | Benutzerdefiniertes Aussehen des Textes im Format von HTML-Style-Attributen, z.B. font-family:sans;font-weight:bold; (neu in 1.5). |
use | Kommaseparierte Liste von zu benutzenden Objekt-Templates. Details siehe template | |
z | 1 | Die z-Option definiert die Reihenfolge, in der die Icons aufeinander gestapelt werden. Das Icon mit dem höchsten Wert wird an der Spitze dargestellt. Das Hintergrundbild hat den Wert 0, so dass gültige Werte 1 oder größer sein müssen. Hinweis: Um Konflikte mit der Header-Navigation zu verhindern, sollte dieser Wert unter 100 bleiben. |
define shape { icon="test" x=200 y=100 }
Wert | Default | Beschreibung |
---|---|---|
Icon | Dateiname des Shapes. Shapes müssen im shape-Verzeichnis abgelegt werden (Default: nagvis/images/shapes ) |
|
x | X-Koordinate | |
y | Y-Koordinate | |
enable_refresh | 0 | Diese Option aktiviert das Shape für regelmäßige Aktualisierungen im Frontent. Dies wird nur für dynamische Shapes benötigt, die sich gelegentlich ändern. |
hover_menu | 0 | Aktivieren/Deaktivieren von Hover-Menüs |
hover_url | URL, der beim Schweben über dem Bild anzuzeigen ist. Normalerweise gibt es keine Aktion während des Schwebens. | |
hover_delay | vererbt (nagvis.ini.php) | Verzögerung der Anzeige des Hover-Menus in Sekunden |
url | URL, auf den das Icon verweisen soll. Normalerweise gibt es keinen Verweis. | |
url_target | _self | Ziel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster) |
use | Kommaseparierte Liste von zu benutzenden Objekt-Templates. Details siehe template | |
z | 1 | Die z-Option definiert die Reihenfolge, in der die Icons aufeinander gestapelt werden. Das Icon mit dem höchsten Wert wird auf der Spitze dargestellt. Das Hintergrundbild hat den Wert 0, so dass gültige Werte 1 oder größer sein müssen. Hinweis: Um Konflikte mit der Header-Navigation zu verhindern, sollte dieser Wert unter 100 bleiben. |
define line { line_type=1 x=200 y=100 }
Wert | Default | Beschreibung |
---|---|---|
line_type | Gibt den Typ der Linie an, wenn view_type=line ist. Gültige Werte sind "11" für Linien mit einem Pfeil an jedem Ende "10" für Linien mit zwei Pfeilen in der Mitte der Linie, die aufeinander zeigen "12" für Linien ohne Pfeile (neu in 1.5) |
|
x | X-Koordinate | |
y | Y-Koordinate | |
hover_menu | 0 | Aktivieren/Deaktivieren von Hover-Menüs |
hover_url | URL, der beim Schweben über dem Bild anzuzeigen ist. Normalerweise gibt es keine Aktion während des Schwebens. | |
hover_delay | vererbt (nagvis.ini.php) | Verzögerung der Anzeige des Hover-Menus in Sekunden |
line_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 (Neu in 1.5.2). |
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
. 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. 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 |