<%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 details, see manual 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.
|
Security Context
|
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. Please choose a user account from the list. The available users depend on your configuration. By default, this is the user that created the map. PRTG Administrator users can change this setting.
|
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.
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 will not appear on the map. Filtering sunburst and treemap objects with multiple tags may not work properly and is not officially supported.
Use this setting with care because it will affect all tables of the current map!
|
|
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 Choose File button and select an image from your computer or network.
Only 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
|
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 (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.
|
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, please see the Get HTML section.
The characters comma "," and colon ":" are not allowed in the secret key field!
|
|
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.
|
Click Save to 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.
In 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.
In 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.
In 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.
Click Save to 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: