New Question
 
 
PRTG Network Monitor

Intuitive to Use.
Easy to manage.

200.000 administrators have chosen PRTG to monitor their network. Find out how you can reduce cost, increase QoS and ease planning, as well.

Free PRTG
Download >>

 

What is this?

This knowledgebase contains questions and answers about PRTG Network Monitor and network monitoring in general. You are invited to get involved by asking and answering questions!

Learn more

 

Top Tags


View all Tags


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

Votes:

0

Your Vote:

Up

Down

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] (10,858) 3 4

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



10 Replies

Accepted Answer

Votes:

0

Your Vote:

Up

Down

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] (10,858) 3 4

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



Votes:

0

Your Vote:

Up

Down

Created on Apr 13, 2010 5:28:52 PM by  Dirk Paessler [Founder Paessler AG] (10,858) 3 4



Votes:

0

Your Vote:

Up

Down

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 by  Carlascom (0) 1

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



Votes:

0

Your Vote:

Up

Down

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

Your Vote:

Up

Down

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 by  martinevans (0)



Votes:

0

Your Vote:

Up

Down

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

Your Vote:

Up

Down

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 by  MDN (0)



Votes:

0

Your Vote:

Up

Down

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

Your Vote:

Up

Down

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 by  b7b7b7b7 (0) 1

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



Votes:

0

Your Vote:

Up

Down

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]



Please log in or register to enter your reply.


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.