<%NUMBERING1%>.<%NUMBERING2%>.<%NUMBERING3%> PRTG Manual: Maps Settings
Using the Map tabs, you can access all functionalities and settings for a map.
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.
For more information, see section Map Designer.
Settings
Click the Settings tab to open a map's general settings.
When using the Add Map dialog, not all of these settings are available. You can change them later by clicking the Settings tab.
|
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.
It 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.
Basically, 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 access rights are.
Map 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.
|
Time Zone
|
Define the time zone that the map uses 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 appear in this map's data tables, including sensors that inherit tags from parent objects. Enter a string or leave the field empty.
For 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 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 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 Image
|
Define if you want to use a background image 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.
Only 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 defined color.
|
|
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.
This 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 geographical map. Workaround: Place an empty, transparent square object over the Geo Map object and link it to an unrelated URL.
Maps 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.
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 System Administration—User Groups settings.
|
Save your settings. If you change tabs or use the main menu without saving, all changes to the settings are lost.
Get HTML
Your map is like a standalone HTML page. You can make it available to others. Depending on the Public Access setting of the map, a visitor needs to provide login credentials 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 a separate web page by 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.
In 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 might 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.
In the URL, usually the IP address is specified via which the page is available. Maybe a NAT is set in your firewall, or you might 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
This shows source code for adding an iframe to a web page. It includes a URL for direct access. Copy the code and paste it into your web page code. Also enable Public Access in the Settings tab.
In the URL, usually the IP address is specified via which the page is available. Maybe a NAT is set in your firewall, or you might 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.
Save your settings. If you change tabs or use the main menu without saving, 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 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