<%NUMBERING1%>.<%NUMBERING2%>.<%NUMBERING3%> PRTG Manual: Maps Settings

Using the Map tabs, you can access all functionalities and settings for a map.

Map Tabs

Map Tabs

View Map

Click the View Map tab any time to show a preview of your map.

Map Designer

Click the Map Designer tab to edit the contents of your map.

icon-book-arrowsFor details, see section Map Designer.

Settings

Click the Settings tab to open a map's general settings.

icon-i-roundWhen using the Add Map dialog, not all of these settings are available. You can change them later by clicking the Settings tab.

Basic Map Settings

Map Name

Enter a meaningful name for the map.

Tags

Enter one or more tags, separated by space or comma. For example, you can use tags later to search for the map. Tags are not case sensitive.

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

Security Context and Color Mode

Define the user account that the map uses for access to monitoring data. The map only contains objects that the selected user is allowed to view. This setting also affects the color mode of maps that are displayed without a PRTG login (public maps). In this case, the color mode setting from the security context user is taken.

Choose a user account from the list. Which user accounts are available depends on your configuration. By default, the security context is the user account that created the map. PRTG System Administrator users can change this setting.

icon-i-blueBasically, the security context is the minimum access right a user account has when viewing a map. If the security context of a map is PRTG System Administrator, every user account sees all objects on the map, no matter what the particular user rights are.

icon-i-roundMap objects of the type Data Tables, for example, include entries according to the security context, but the table headings regard to the rights of the particular user account that views the map. Because of this, a user might see more objects in the table itself than denoted in the header.

Timezone

Define the timezone that the map uses for all date-specific options. Select a timezone from the list.

Tag Filter

This setting affects table map objects. Enter one or more tags separated by spaces or commas to include sensors in tables. Only sensors with one of the tags entered here appear in this map's data tables, including sensors that inherit tags from parent objects. Enter a string or leave the field empty.

icon-i-roundFor some map objects like sunburst and treemap, the tag filter applies to devices, groups, and probes. If you use only tags of sensors, these map objects do not appear on the map. Filtering sunburst and treemap objects with multiple tags may not work properly and is not officially supported.

icon-i-round-redUse this setting with care because it affects all tables of the current map!

Map Layout

Map Width

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

Map Height

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

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. Choose this method if the map is shown on various screens with different resolutions so that it uses the available space in the browser window in the best possible way.
  • Do not auto-scale map view: The map always uses the width and height that you define above.

Background Picture

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

  • Use an image in the background of the map: Use a custom background image that you define below.
  • Do not use a background image: Do not use a background image.

Background Image

This field is only visible if you enable Use an image in the background of the map above. Click the Select File button and select an image from your computer or network.

icon-i-roundOnly images in JPG, PNG, and GIF format are supported. The file size must be smaller than 20 MB. If you try to upload other images, you get an error message.

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 currently defined color.

Public Access

Public Access

Define if others can see the map:

  • No public access (map cannot be viewed without login): Do not allow public access to the map. Only users with both a login to the PRTG web interface and sufficient access rights can see the map.
  • Allow public access (map can be viewed by using a unique URL): Allow access to the map using a unique address. The URL contains a key that you can change below. The map is an interactive public map.
  • Allow public access, disable all links except for Geo Maps (map can be viewed by using a unique URL): Allow access to the map using a unique address. The URL contains a key that you can change below. If you choose this option, all links on the map are disabled, so it is a non-interactive public map.
    icon-i-blueThis option does not apply to geographical maps embedded in your map. It is not possible to disable the links in map objects that contain a Geo Map. Workaround: Place an empty, transparent square object over the Geo Map object and link it to an unrelated URL.

icon-i-roundMaps with public access are displayed using the color mode from the security context user. See Security Context and Color Mode for more information.

Secret Key

This field is only visible if you enable a public access option above. The 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.

icon-book-arrowsFor more information on public access, see section Get HTML.

icon-i-round-redThe characters comma "," and colon ":" are not allowed in the secret key field!

Access Rights

User Group Access

Define which user groups have access to the object that you are editing. A table with user groups and rights is shown. It contains all user groups from your setup. For each user group, you can choose from the following access rights:

  • Inherited: Use the settings of the parent object.
  • None: Users in this group cannot see or edit the object. The object does not show up in lists.
  • Read: Users in this group can see the object and review its settings.
  • Write: Users in this group can see the object, as well as review and edit its settings. However, they cannot edit access rights settings.
  • Full: Users in this group can see the object, as well as review and edit its settings as well as edit access rights.

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

icon-i-round-redSave your settings. If you change tabs or use the main menu, all changes to the settings are lost.

Get HTML

Your PRTG map is like a standalone HTML page. You can make it available to others if you like. Depending on the Public Access setting of your map, a visitor needs to provide PRTG user account login data to view the map, or sees the map immediately using a URL containing a secret key. When using this unique key, you can also include your map on another web page, embedding it via <iframe>.

  • Option 1: Link to a web page with the map that requires login credentials
    The shown URL requires login credentials to display the map. PRTG asks the user trying to view the map via this URL for login credentials.
    icon-i-roundIn the URL, usually the IP address is specified via which the page is available. Maybe a network address translation (NAT) is set in your firewall, or you may want to use a domain name or a name from a dynamic Domain Name System (DNS) service for public access. Customize the URL you use for access to your needs.
  • Option 2: Link to a web page that displays the map without a login
    To get the shown URL to work for public access without a login, enable Public Access in the settings tab of your map.
    icon-i-roundIn the URL, usually the IP address is specified via which the page is available. Maybe a NAT is set in your firewall, or you may want to use a domain name or a name from a dynamic DNS service for public access. Customize the URL you use for access to your needs.
  • Option 3: Show a map inside other web pages using an IFRAME
    For your convenience, this shows source code for adding an iframe to another web page. It includes a URL for direct access. Just copy the code and paste it into your web page code. Also enable Public Access in the settings tab.
    icon-i-roundIn the URL, usually the IP address is specified via which the page is available. Maybe a NAT is set in your firewall, or you may want to use a domain name or a name from a dynamic DNS service for public access. Customize the URL you use for access to your needs.

While a map is shown via these URLs, you can change the refresh interval any time by hovering over the arrows symbol in the lower-right corner. Choose from 10, 30, or 60 seconds, 10 minutes or Refresh now. The map automatically adapts to the size of the browser window if you enable the auto-scaling setting.

Comments

On the Comments tab, you can enter free text for each object. You can use this function for documentation purposes or to leave information for other users.

icon-i-round-redSave your settings. If you change tabs or use the main menu, all changes to the settings are lost.

History

On the History tab, all changes in the settings of an object are logged with a time stamp, the name of the PRTG user who made the change, and a message. The history log retains the last 100 entries.

Delete

You can delete the entire map any time by clicking the trash can symbol in the upper-right corner.

More

PRTG Manual:

 

Keywords: