This article applies to PRTG Network Monitor 13.2.3 or later
Adding and Customizing Map Objects
A word of caution
This post contains information about internals of PRTG that may change in future versions. Please note that we provide this information without warranty and that we cannot officially support you with this. Please make sure you keep a proper backup of your configuration and data files.
All map objects used by PRTG are stored in one HTML file for each object in the folder:
\prtg network monitor\webroot\mapobjects
Note: In versions previous to PRTG 13.2.3, the path is "\prtg network monitor\website\mapobjects".
You can add as many new objects as you want to by duplicating one of the existing files and editing it as desired. We do not recommend editing the original files supplied by PRTG because your changes may be overwritten when an update is installed.
For example the map objects file for "With Name and Last Value, White Background" looks like this:
<!--Status Icons (for Sensors Only): With Name and Last Value, White Background-->
<div class="map_object map_icon" objectid="<@objectid>" subid="<@subid>" style="<#mapobject type="topleftcoordinates" subid="<@subid>" mode="<@editmode>">">
<#mapobject type="objectgrip" mode="<@editmode>">
<#mapobject type="htmlbefore" subid="<@subid>">
<span>
<#objectstatus name="downsens" id="<@objectid>">
<#objectstatus name="downacksens" id="<@objectid>">
<#objectstatus name="warnsens" id="<@objectid>">
<#objectstatus name="upsens" id="<@objectid>">
<#objectstatus name="pausedsens" id="<@objectid>">
<#objectstatus name="unusualsens" id="<@objectid>">
<#objectstatus name="undefinedsens" id="<@objectid>">
<#objectproperty name="ParentDevice" show="text" id="<@objectid>">
>
<#objectproperty name="Name" id="<@objectid>">:
<#objectstatus name="lastvalue" id="<@objectid>">
</span>
<#mapobject type="htmlafter" subid="<@subid>">
</div>
Naming a Map Object
The first line of the file contains the groupname and map objects name for display in the map editor. You can edit these as desired.
<!--Status Icons (for Sensors Only): With Name and Last Value, White Background-->
BTW, map objects are displayed in the selection list of the map editor in the alphabetic order of their filenames.
Editing the Placeholders
Important: Apart from the object name you should only edit the section between the <span> and </span> tags.
You can see many placeholders <#tagename....>. These are replaced with a sensor's/devices's information at runtime.
The <#objectstatus name="xxsens"> tags will be replaced with the colored sensor icon.
The <#objectproperty> tags are used to display the name, etc.
For example in order to only show the sensor icon and the last value please use the following code between the <span> and </span> tags:
<span>
<#objectstatus name="downsens" id="<@objectid>">
<#objectstatus name="downacksens" id="<@objectid>">
<#objectstatus name="warnsens" id="<@objectid>">
<#objectstatus name="upsens" id="<@objectid>">
<#objectstatus name="pausedsens" id="<@objectid>">
<#objectstatus name="unusualsens" id="<@objectid>">
<#objectstatus name="undefinedsens" id="<@objectid>">
<#objectstatus name="lastvalue" id="<@objectid>">
</span>
Add comment