What is this?

This knowledgebase contains questions and answers about PRTG Network Monitor and network monitoring in general.

Learn more

PRTG Network Monitor

Intuitive to Use. Easy to manage.
More than 500,000 users rely on Paessler PRTG every day. Find out how you can reduce cost, increase QoS and ease planning, as well.

Free Download

Top Tags


View all Tags

How can I add or edit map objects used for PRTG's maps?

Votes:

1

We are attempting to build some useful Maps for our environment, and find the feature has great potential. However, we are unable to find a way to build a map containing the data we want. Or more accurately, we are unable to find a sensor 'Template' that works well.

Quite simply, we want the sensor reading, and just sensor reading (including the Unit identifier). The display position on the map (overlay of the datacenter) is more than sufficient to indicate which device we're talking about.

  • Status Icon with Name - is too long.
  • Status Icon with no name - is nice, but we really want the number as well.
  • With Name and Last Value - shows the value we want (sans unit), but the name gets in the way.

Ideally, we would like to see:

  • "Status Icon with Last Value (including units)" - or -
  • "Last Value (including units) color coded to status".

Can we add our own (or edit existing) map objects accordingly?

customization map-objects maps prtg

Created on Mar 3, 2010 11:14:59 AM by  Dirk Paessler [Founder Paessler AG] (11,025) 3 6

Last change on Mar 3, 2010 11:17:26 AM by  Daniel Zobel [Product Manager]



13 Replies

Accepted Answer

Votes:

1

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>">

&gt; 
<#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>

Created on Mar 3, 2010 11:23:16 AM by  Dirk Paessler [Founder Paessler AG] (11,025) 3 6

Last change on Aug 22, 2014 2:02:53 PM by  Gerald Schoch [Paessler Support]



Votes:

0

Created on Apr 13, 2010 5:28:52 PM by  Dirk Paessler [Founder Paessler AG] (11,025) 3 6



Votes:

0

Hi, I would like to add a my custom object, that's show me a list of down sensors and warnings, in fact a object like 'Alarms small' and 'DOWN SENSORS', without ack and unusual sensors-

I create new html file in folder c:Program Files (x86)\PRTG Network Monitor\webroot\mapobjects

But I can't see on object list on map (I restart core probe)

this is html

<!--Data Tables: Alarms small My View-->

<div class="map_object map_table" id="<@itemid>" objectid="<@objectid>" subid="<@subid>" style="overflow:auto;<#mapobject type="coordinates" subid="<@subid>" mode="<@editmode>">">
  <#mapobject type="objectgrip" mode="<@editmode>">
  <#mapobject type="htmlbefore" subid="<@subid>">
  <#checkobjecttype objecttype="probenode,group,device" nicemessage="true" id="<@objectid>">
  <div class="maptablecontainer" style="overflow:hidden">
    <#lang key="html.dashboard.alarms" default="Alarms" var="alarms">
    <#lang key="html.dashboard.warnings" default="Warnings" var="warnings">
    <#objectstatus name="downsens" id="0" show="htmllink" var="alarmcount">
    <#objectstatus name="warnsens" id="0" show="htmllink" var="warningcount">
    <#objectproperty name="name" var="objname" id="<@objectid>">
    <b><#inserthtml html="@alarmcount @alarms, @warningcount @warnings, (@objname)" varexpand="html"></b>
		
    <#table tableid="dashalarmtable_myview"
      content="sensors"
      id="<@objectid>"
      columns="downtimesince,device,sensor"
      count="50"
      sortby="downtimesince"
      links="false"
      sortable="false"
      infoheader="false"
      filter_tags="@tag(<@tagfilterstring>)"
      filter_status="5"
      filter_status="4"
      filter_status="13"
      filter_status="14"
      filter_status="10">
  </div>
  <#mapobject type="htmlafter" subid="<@subid>">
</div>

Created on Jan 23, 2017 1:16:16 PM

Last change on Jan 23, 2017 4:01:12 PM by  Torsten Lindner [Paessler Support]



Votes:

0

Hi Carlascom,

If you save the attached code as *.htm and save it to "\PRTG Network Monitor\webroot\mapobjects" on your PRTG Core Server you will find the map object within the Properties Tree under Data Tables > Alarms small My View.

Best,
Sebastian

Created on Jan 24, 2017 11:20:29 AM by  Sebastian Kniege [Paessler Support]



Votes:

0

Hi All,

Further to the questions below regarding Maps, is there any way to edit the Sensors displayed in the Graphs in the Map Tool? I am trying to create a Storage Map of our estate, but dont want to show Sensors such as "Downtime" in the graphs.

Thanks

Martin

Created on Mar 8, 2017 10:52:02 AM



Votes:

0

Hi Martin,

To hide certain channels of a sensor in the graphs, navigate to the sensor and open the channel settings of the channel you want to hide. Afterwards enable the "Hide from Graphs" option under "Graph Rendering" and the channel will be hidden in all graphs.

Best regards.

Created on Mar 9, 2017 8:48:33 AM by  Dariusz Gorka [Paessler Support]



Votes:

0

Hi, I copied a file (messageonly_on_white.htm) and gave it a new name: messageonly_on_blue.htm In the file the first line was changed from <!--Status Icons: Sensor Message only (On White)--> to <!--Status Icons: Sensor Message only (On Blue)-->

But the new Status Icon does not show up in the list. I also rebooted the server, but the results are the same.

I gave the file a new name and changed the first line. What else do I need to do?

Created on Mar 22, 2017 9:29:05 AM



Votes:

0

Dear MDN,

What version of PRTG are you currently running?

Unfortunately, I am unable to recreate your described steps (copied and renamed the file accordingly, edited only the first line of HTML code, restarted the PRTG Core Server).

The map object is stored under Status Icons | Sensor Message only (On Blue) here.

Best,
Sebastian

Created on Mar 22, 2017 7:59:18 PM by  Sebastian Kniege [Paessler Support]



Votes:

0

Hi, I would like to add my custom object to the map. I have created a new map object in mapobjects folder "Added Objects LSI.htm" with a code below and I put my PNG-Image into the folder ../images/ (or tried also to put my image in this folder ..mapicons/iconset7/ - the result is the same). The problem is, that the picture is non strechtable.

<!-- SEW Objects: LSI -->

<div class="map_object map_icon2 <#sensor type="colorclassofstate" prefix="map_iconcolor_" id="<@objectid>">" id="<@itemid>" objectid="<@objectid>" subid="<@subid>" style="<#mapobject type="coordinates" 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>">

&gt; 
<#objectproperty name="Name" id="<@objectid>">:
<#objectstatus name="lastvalue" id="<@objectid>"> 
</span>

  <img src="/images/LSI_128x128.png">
  <#mapobject type="htmlafter" subid="<@subid>">
</div>

If I use a standard objects from groups Icons A, B or C, it works. If I make an object smaller, then the picture inside of this object will be also smaller. How can I fix it in my object? Thanks in advance. Example picture here.

solved: This string below is responisible for showing the image and will be edited like usual html-language as I undersand. <img src="/mapicons/iconset7/LSI_128x128.png" width="<@width>px">

Created on Dec 14, 2018 1:17:23 PM

Last change on Dec 17, 2018 10:09:33 AM by  Dariusz Gorka [Paessler Support]



Votes:

0

Hi there,

Please change the following image part from:

<img src="/images/LSI_128x128.png">

To the following:

<img src="/images/LSI_128x128.png" height="100%" width="100%">

That should do the trick.

Best regards.

Created on Dec 17, 2018 8:15:48 PM by  Dariusz Gorka [Paessler Support]



Votes:

0

how to set to show ping only ? filter ping sensor only

Created on Mar 2, 2021 4:39:40 AM



Votes:

0

Hi there,

The following URL shows only Ping Sensors:

Http(s):YourPRTGWebServer/sensors.htm?filter_type=ping

The bold string is the certain filter rule.

Created on Mar 2, 2021 11:56:03 AM by  Moritz Heller [Paessler Support]



Votes:

0

Hi, i would like to have a mapobject to list a tree (without sensors and groups) of all probes on a core server, without extended view and not editable!
I've edit a copy of <tabletree01.htm> and renamed it. But i get not the result i wish.

Can you help me to develop this object?

Created on Mar 31, 2021 12:51:53 PM

Last change on Mar 31, 2021 12:57:31 PM by  Felix Wiesneth [Paessler Support]




Disclaimer: The information in the Paessler Knowledge Base comes without warranty of any kind. Use at your own risk. Before applying any instructions please exercise proper system administrator housekeeping. You must make sure that a proper backup of all your data is available.