<%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 manual 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.

Security Context and Color Mode

Define the user account that the map will use for access to monitoring data. The map will only contain 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. The available users depend 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 will see all objects on the map, no matter what the particular user rights are.

icon-i-roundMap objects of 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 time zone that the map will use for all date-specific options. Select a time zone 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 will appear in this map's data tables, including sensors that inherit tags from parent objects. Please 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 will 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 will affect all tables of the current map!

Map Layout

Map Width

Define the width of the map in pixels. Please enter an integer value.

Map Height

Define the height of the map in pixels. Please enter an integer value.

Automatic Scaling

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

  • Scale map view to fit browser size: The size of the map adapts automatically 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 place in the browser window the best possible way.
  • Do not auto-scale map view: The map uses always the size that you define above.

Background Picture

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

  • 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 option is only visible if you enable a background picture above. Click the Select File button and select an image from your computer or network.

icon-i-roundOnly images in the format JPG, PNG, and GIF 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 will always display the currently defined color.

Public Access

Public Access

Define if others can see the map. Choose between:

  • 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 will be 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 will be 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 public access is enabled 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. For more information on public access, see the Get HTML section.

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

Access Rights

User Group Access

Define which user group(s) will 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.

Save your settings. If you change tabs or use the main menu, all changes to the settings will be lost!

Get HTML

Your PRTG map is like a standalone HTML page. You can make it accessible 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 webpage, embedding it via <iframe>.

  • Option 1: Link to a web page with the map that requires login credentials
    The shown URL requires login credentials in order 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 given via which the page is available. Maybe a NAT translation 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. Please 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 working 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 given via which the page is available. Maybe a NAT translation 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. Please 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 webpage. It includes a URL for direct access. Just copy the code and paste it into your webpage code. Also enable Public Access in the settings tab.
    icon-i-roundIn the URL, usually the IP address is given via which the page is available. Maybe a NAT translation 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. Please 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 between 10, 30, or 60 seconds, 10 minutes or Refresh now. The map adapts automatically 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.

Save your settings. If you change tabs or use the main menu, all changes to the settings will be lost!

History

In the History tab all changes in the settings of an object are logged with a timestamp, 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 symbol on the right.

More

PRTG Manual:

 

 

Keywords: