skip to main content
Nagvis
  
NagVis
Introduction
NagVis is a visualization add-on for op5 Monitor and it is used to visualize op5 Monitor data, e.g. to display business processes like a mail system, network infrastructure or critical production processes.
In this chapter each type of map will be described. You will also learn how to complete the most common tasks like how to
add, edit and delete maps
add, edit and delete objects
change global configuration
The first thing you will see when you open up NagVis in op5 Monitor is a few default demo maps, Automap and Geomap.
The picture below shows an example of how the view may look like.
It is from this view you can display and manage you maps.
Configuration interface
All settings are administrated through the Configuration Interface. The Configuration Interface can be reached either from the configuration link at the top of the default view or from the edit buttons in the header of all plain maps in the thumbnail view on NagVis first page.
Main configuration interface
To open up the Configuration Interface
1 Click on NagVis in the main menu of op5 Monitor.
2 Click on the (Configure) link at the top of the page.
3 Right click anywhere in the page and the Configuration Interface will show up.
From here you may now:
change the global configuration
add, edit and delete map and objects
add and delete background images
add, edit and delete shapes
configure the backend.
Configure plain maps
To configure a plain NagVis map
1 Click on NagVis in the main menu of op5 Monitor.
2 Click on the (Configure) icon in the header at the top of every plain NagVis map.
3 Use the menu on the top to access the Configuration Interface.
NagVis maps
As you have seen there are a couple of demo maps in the default configuration. They are included so you have something to start with when you are using NagVis for the first time.
Manage backgrounds
When you start to create your own maps you will need to have a background image. The background image can be what ever you want.
The following image types are supported:
jpeg
png
gif
Add
To add a new background image
1 Follow the instructions in Main configuration interface on page 69 about how to open up the Configuration Interface.
2 Go to the menu on top and select Options -> Manage Backgrounds
3 Click on Choose File in the Upload background image and choose the image to upload.
4 4. Click Upload. Now your background image is ready to use.
Delete
To delete a background image
1 Follow the instructions in Main configuration interface on page 69 about how to open up the Configuration Interface.
2 Go to the menu on top and select Options -> Manage Backgrounds
3 Under Delete background image choose the background image you like to remove and click Delete.
Manage maps
Add
There Add are two ways to add a new map to NagVis.
To add a new map
Alt. 1
1 On the NagVis default page type in the name of the new map in the Create Map box:
2 Click Create.
 
The map name can not contain any spaces
Alt. 2
1 Follow the instructions in Main configuration interface on page 69 about how to open up the Configuration Interface.
2 Go to the menu on top and select Options -> Manage Maps
3 Now fill in the following fields:

Option
Description
Map name
The map name without space in the name. 1
Map Iconset
Choose what iconset you like to use.
Background
Choose what background image you like to use.

1 This will be the name of the map and used both in URLs and it will be the name of the configuration file in the file system

4 Click on the ”Create“ button and your map is created and ready to be filled with objects.
Change options
Since the Add new map window is pretty limited you probably want to change some of the options for your newly created map.
To find the Option window for your map.
1 Follow the instructions in Main configuration interface on page 69 about how to open up the Configuration Interface. Remember to chose what map to edit.
2 Go to the menu on top and select Map -> Map Options
The number of options is large. For more information about the options please read more in the official NagVis Manual at:
http://www.nagvis.org/documentation
Deleting a map
There are two ways to delete a map.
To delete a map
Alt. 1
1 Click delete icon in the header of a plain NagVis map
2 Click Ok and the map is deleted.
Alt. 2
1 Follow the instructions in Main configuration interface on page 69 about how to open up the Configuration Interface.
2 Select Maps -> Manage Maps from the menu on top
3 Under Delete map choose the map you like to remove and click Delete.
4 Click Ok in the pop-up question to deleted the map.
Once the map is removed you will be redirected to the NagVis WUI page.
Renaming a map
To rename a map
1 Follow the instructions in Main configuration interface on page 69 about how to open up the Configuration Interface.
2 Go to the top menu and choose Options -> Manage Maps
3 Select the map you like to rename.
4 Type the new name in the New name text field and click Rename.
5 Click Ok in the pop-up dialog that shows up and the map will be renamed.
Map object types
A map can have three types of objects. See the list of objects below:
Icon
Line
Special
Each object type consist of a number of objects that may be used in a map. The table below briefly describes what objects each type includes:
 
Object Type
Objects
Icon
Host
Service
Hostgroup
Servicegroup
Map
Line
Host
Service
Hostgroup
Servicegroup
Map
Special
Textbox
Shape
Stateless Line
If a host is in a problem state or a service on that host is in a problem state the host will be displayed in a non-green color (red, yellow or grey).
If you hover the mouse over an object you will get a summary of how the current object.
Icon objects
As you can see in the table in Map object types on page 78 the type Icon consists of five different objects. All of them are icons that displays status of a certain object in op5 Monitor. They will change color depending of the status of the corresponding object in op5 Monitor.
Adding a host icon
To add a host icon
1 Follow the instructions in Main configuration interface on page 69 about how to open up the Configuration Interface.
2 Go to the menu on top and select Map -> Add Icon -> Host
3 You will now get a mouse pointer looking like a cross:

Click on the map where you like to add your host.
4 A box with the host options is now shown.

The options marked with red text are mandatory. So the host name is the only one you have to change for now.
5 Click Save and your object is saved on the map.
Line objects
A line object is a printed line between two objects. It can symbolize a connection between two icon objects and be associated with a Nagios object.
Adding a line
Here we will add a line between two hosts and connect it to a switchport Bandwith Usage check.
To add a line
1 Follow the instructions in Main configuration interface on page 69 about how to open up the Configuration Interface.
2 Go to the menu on top and chose: Map -> Add Line -> Service
3 Place the line between your objects like this:
a Click on the host icon you like to start your line from.
b Drag the mouse to the other host you like to connect the line to.
c Click where you like to end the line.
4 A box with the line options is now shown.

The options marked with red text and line type are mandatory. So the host name, service descriptions and line type the only one you have to change for now.
5 Select line_type. The line type “--%--><--%--” is used for presenting the usage in percent.
 
The line type “--%+BW--><--%+BW--” is used for showing both percentage and BandWith. This line does not work with the standard traffic check.
6 Click Save and your object is saved on the map.
Note that the percentage is not viewable in configuration mode.
Deleting objects
To delete an object
1 Follow the instructions in Main configuration interface on page 69 about how to open up the Configuration Interface.
2 Right click on the object icon and the following dialog is shown
3 Click Delete
4 Select OK in the pop-up dialog and the object is removed.
Modifying objects
To modify an object
1 Follow the instructions in Main configuration interface on page 69 about how to open up the Configuration Interface.
2 Right click on the object icon and the following dialog is shown.
3 Click Modify and the object option box is shown.
Automap
When you take a look at the Automap for the first time you will see the complete tree, including all your hosts. If you only like to see one part of the tree you have to change the following configuration setting:
defaultroot
Defaultroot tells Nagvis what host to start your tree with.
Example 1 Example of how the defaultroot works in NagVis Automap
In this example we have the following tree in op5 Monitor.
As you can see here the monitor host is marked with a line around it. That mark indicates that monitor is set to defaultroot and all of its children are displayed.
If you set the host fw01 as defaultroot in Nagvis the automap only display fw01 and it’s children (www.example.net and www.op5.com). The picture below shows how it would look like:
 
Setting defaultroot
This is done when you have one of the maps in Edit mode. There is no Edit mode on the automap so these steps have to be done on another map.
To set defaultroot.
1 Follow the instructions in Main configuration interface on page 69 about how to open up the Configuration Interface.
2 Go to the top menu and choose: Option -> General Configuration
3 In the Automap section and type in the complete host name in the “defaultroot” text box:
4 Click Save and the new setting has been saved.
Rotation pools
The Rotation pools are just sets of NagVis maps that are used to rotate between. So you can open up a rotate pool to have your maps shown for a certain time and then the rotate function will switch to the next map in the pool.
Note: Neither automap nor Geomap kan be used in a rotation pool.
There is no GUI to use for administration of the rotate pools. You have to edit the nagvis.ini.php file that is located here:
/opt/monitor/op5/nagvis_ls/etc/nagvis.ini.php
Adding a rotation pool
To add a new rotation pool you have to edit nagvis.ini.php. Look in the file for the following section:
; ----------------------------
; Rotation pool definitions
; ----------------------------
To add a rotation pool
1 1. Logon to your op5 Monitor server, as root, via ssh or directly at the console.
2 2. Open up nagvis.ini.php in your favorite editor.
3 3. Go down to the ”Rotation pool definitions“ and add the following lines:
[rotation_demo]
rotationid="demo"
maps="demo,Demo2:demo2"
interval=15

The table below describes the options shown above:
Option
Description
[rotation NAME]
NAME is the displayed name of this rotation pool on NagVis default page.
rotationid=”NAME”
NAME is the ID of this rotation pool, need to be the same as NAME in [rotation_NAME].
maps=”map1,map2:Maps”
The Maps is a label which is being displayed in the index pages rotation list.
interval=15
15 is the rotation time in seconds between the maps.
 
 
Maps must be named exactly the same as the corresponding cfg file.
4 Save and quit your editor.
5 Go back to your browser and reload the NagVis default page