<%NUMBERING1%>.<%NUMBERING2%>.<%NUMBERING3%> PRTG Manual: Map Designer

Use the Map Designer to create a map web page representing your network.

This documentation refers to an administrator user accessing the PRTG web interface on a master node. If you use other user accounts, interfaces, or failover nodes, you might not see all of the options in the way described here. If you use a cluster installation, note that failover nodes are read-only by default.

In this section:

• Use the Proper Browser
• Basic Design Concept
• Device Tree Selection
• Properties Selection
• Edit Map Items—Properties Box
• Edit Map Items—Edit Icons
• Edit Map Items—Using Cursor Keys
• Draw Connection Lines Between Items
• Snap To Grid
• Undo and Redo
• More

Use the Proper Browser

Because of the map designer's extensive scripting capability, it is important that you use a compatible browser when editing maps. We recommend that you use Google Chrome 72. You can also use Mozilla Firefox 65 or Microsoft Internet Explorer 11. The map designer is not fully compatible with earlier versions of Internet Explorer, or Opera browsers.

Basic Design Concept

Click the Map Designer tab to open the editor. It might take a few moments to load. Here, you can create your map by adding or changing items. The Map Designer consists of three main parts: The Device Tree on the left, the map in the middle, and the Properties on the right.

Each map item takes attributes from both selections.

• Device Tree (left): Select the object whose data you want to show on the map.
• Properties (right): Define how to show the map item.

Drag and drop any object from either side onto the map, or double-click an object. You always see all changes immediately.

Device Tree Selection

Use the Device Tree to select the object whose data you want to show on the map (this can be a probe, a group, a device, or a single sensor). To find the desired object, you have the following options:

• Use the arrow symbols at the beginning of each line to expand or collapse objects in the device tree and show objects below probes, groups, and devices.
• Enter a few characters into the Search box in the upper-right corner to search for names (or parts of names) of objects in your configuration. You see the search results immediately. Click the gray x icon to clear your search.

• No matter which method you choose to find the desired object, you can always drag any object from the Device Tree onto a free area of the map to create a new map item.
• If you drag it onto a map item, it replaces the item while Properties and size stay the same.
• You can also select a map item and double-click a Device Tree object to replace the map item. If no item is selected, double-clicking an object adds a new map item.
• To gain more space for map editing, reduce the size of the Device Tree box by dragging its right border to the left. Drag it to the right to enlarge it again.

Properties Selection

Use the Properties selection to define how to show the map item (for example, as an icon, a map, a table, or a graph). Select the appearance from different categories. Hover over a Properties object to get a live preview of it (in most cases).

If a certain Properties object is not available for the selected Device Tree object, you see a corresponding note in the live preview of the Properties object.

Many different Properties object types are available. Click one of the categories to show all available types.

No matter which object you choose, you can always drag any object from the Properties box onto a free area of the map to create a new map item. If you drag it onto a map item, it replaces this item, while its Device Tree object attributes and size stay the same. You can also select a map item and double-click an object in the Properties box to replace the map item. If no item is selected, double-clicking an object adds a new map item.

Edit Map Items—Properties Box

Click a map item to select it. You can then edit its attributes using the fields in the upper part of the Properties box:

Edit Map Items—Edit Icons

Hover over a map item to show the edit icons for it.

Edit Map Items—Using Cursor Keys

While an object is selected, use the cursor keys to move it one pixel at a time. Hold down the Shift key in combination with the cursor keys to move the object 10 pixels at a time.

Add Custom Text to the Map

You can add custom text with individual styling to your map using the Custom HTML Element.

For more information, see the Knowledge Base: How to add text to a map?

Draw Connection Lines Between Items

You can draw connection lines between any map items via drag-and-drop. Click the gray handle to the left of an item and drag a line to the item that you want to draw a connection to. A line between these items appears immediately. This can be useful to indicate network connections or logical coherence between two items. To delete connection lines, click the scissors symbol in the item's edit icons.

You also delete a connection line by hovering over the connection line and clicking the scissors symbol.

Lines between objects are colored dynamically depending on the status of linked objects. For example, a line is red as long as one of the object's icons shows a red Down status. This only affects half of the line, at the end where the red sensor is shown. If both objects connected show a red sensor, this results in a continuous red line.

Snap to Grid

Select Snap to Grid below the Device Tree box to define how map items are positioned when you add or remove them via drag-and-drop. The setting is immediately active. If you enable Snap to Grid, you can only place items so that they are aligned with the grid. If you disable the Snap to Grid option, you can place map objects freely.

Undo and Redo

You can revert previous changes to the map and its objects with the Undo button (Ctrl+Z) in the Device Tree box. To revert undo actions, use the Redo button (Ctrl+Y). You can undo and redo up to 50 changes when you work on a map. Because PRTG saves changes persistently in your configuration, you can even revert changes later.

Both buttons are only available if they can apply, otherwise they are grayed out.

More

KNOWLEDGE BASE

Why does my browser show an unresponsive script warning while loading the Map Designer?

• https://kb.paessler.com/en/topic/19483

Which audible notifications are available in the PRTG web interface and in PRTG Desktop?

• https://kb.paessler.com/en/topic/26303

Why are audible alerts in public maps not working in Chrome?

• https://kb.paessler.com/en/topic/83142

How to add text to a map?

• https://kb.paessler.com/en/topic/11523