PRTG Manual: Maps Settings

Map Name

Enter a name to identify the map.

If the name contains angle brackets (<>), PRTG replaces them with braces ({}) for security reasons. For more information, see the Knowledge Base: What security features does PRTG include?

Tags

Enter one or more tags. Confirm each tag with the Spacebar key, a comma, or the Enter key. You can use tags to group objects and use tag-filtered views later on. Tags are not case-sensitive. Tags are automatically inherited.

It is not possible to enter tags with a leading plus (+) or minus (-) sign, nor tags with parentheses (()) or angle brackets (<>).

For performance reasons, it can take some minutes until you can filter for new tags that you added.

Security Context and Color Mode

Define the security context that the map uses for access to monitoring data. Select a user account from the dropdown list to define which objects are visible on the map. The map only contains objects that the selected user has the access rights to view. By default, the security context is the user account that creates the map.

Basically, the security context defines the minimum access rights to objects like libraries, reports, or maps, that a user account has. If the security context of an object is PRTG System Administrator, for example, every user sees all objects in a library, in a report, or on a map, no matter what the particular user access rights are.

This setting also affects the color mode of public maps. PRTG takes the color mode setting of the security context user account.

Time Zone

Define the time zone that the map uses for all date-related settings. Select a time zone from the dropdown list.

Filter by Tag

This setting applies to table map objects. Enter one or more tags separated by a space or comma to include sensors in map data tables. Only sensors that have one of the specified tags appear in the tables, including sensors that inherit tags from parent objects. Enter a string or leave the field empty.

For performance reasons, it can take some minutes until you can filter for new tags that you added.

For some map objects, for example for sunburst and treemap objects, the tag filter applies only to probes, groups, and devices. If you only enter tags of sensors, these map objects do not appear on the map. Filtering sunburst and treemap objects with multiple tags might not work properly and is not officially supported.

Use this setting with caution because it affects all tables of the map.

Map Width

Define the width of the map in pixels. Enter an integer.

Map Height

Define the height of the map in pixels. Enter an integer.

Automatic Scaling

Define if you want the map to automatically adapt to your screen size:

• Scale map view to fit browser size: The size of the map automatically adapts to the size of your screen. We recommend that you use this option if you display the map on different screens with different resolutions.
  This setting does not apply to the map designer.
• Do not automatically scale map view: The map always uses the specified width and height settings.

Background Image

Define if you want to use a background image for the map:

• Use a background image: Use a custom background image, for example, your company logo.
• Do not use a background image: Use a background that shows the color that you define in the Background Color setting.

Custom Image

This setting is only visible if you select Use a background image above. Click Select File and select an image from your system or network.

PRTG only supports images in JPG, PNG, and GIF format. The file size must be smaller than 20 MB.

Background Color

Select a background color for this map. Either enter a hex color code or choose a color from the color selector. The hex color code field always displays the defined color.

Public Access

Define who can view the map:

• No public access: Do not allow public access to the map. Users who want to view the map first need to log in to PRTG. They also need sufficient access rights to the map.
• Allow public access: Allow access to the map via a unique URL. The URL contains a secret key that you can change. The map is an interactive public map.
• Allow public access but disable all links except for Geo Maps: Allow access to the map via a unique URL. The URL contains a secret key that you can change. If you select this option, all links on the map are disabled so that you get a non-interactive public map.
  It is not possible to disable the links in map objects that contain an embedded geographical map. As a workaround, place an empty, transparent square object over the Geo Map object and link it to an unrelated URL.

PRTG displays maps with public access in the color mode defined for the security context user account.

Secret Key

This setting is only visible if you select Allow public access or Allow public access but disable all links except for Geo Maps above. The secret key is automatically generated. It is part of the public URL for the map. You can also enter a customized string.

We recommend that you use the default value.

For more information on public access, see section Get HTML.

The characters comma (,) and colon (:) are not allowed in the secret key field.

User Group Access

Define the user groups that have access to the object. You see a table with user groups and group access rights. The table contains all user groups in your setup. For each user group, you can choose from the following group access rights:

• No access: Users in this user group cannot see or edit the object. The object does not show up in lists.
• Read access: Users in this user group can see the object and view its settings.
• Write access: Users in this user group can see the object and view and edit its settings. However, they cannot edit the object's access rights settings.
• Full access: Users in this user group can see the object, view and edit its settings, and edit its access rights settings.

You can create new user groups in the User Groups settings.