Network Map

Service

To add an icon to represent a service, go to Edit Map | Add Icon | Service, then from the “host_name” pull down menu, select the name of the host from which you wish to select a service. Then from the “service_description” menu, select the name of the service. Leave the other default options as is and click “Save”. Repeat these steps for any additional services that you wish to add to your map.

It’s important to first select the name of the host, as this will affect the contents of the “service_description” menu to reflect all available service associated with the host.

If you want to get more information about the other available parameters, read bellow.

Value Default Description
host_name none Name of the host as defined in APM
service_description none Name of the service as defined in APM
x none X axis coordinate
y none Y axis coordinate
backend_id inherited Backend-ID defined in Main Configuration file where Network Map should search for the object states. If this parameter is not given, the Backend which was set in global section of the map is taken.
context_menu inherited Enable/Disable the context menu for this object.
context_template inherited Context template for this object.
gadget_url none The value can be a gadget script in gadget path (path/gadgets) e.g. “std_speedometer.php” or a full URI to a gadget like script surrounded by brackets. This option is only recognized when view_type=“gadget” is set.
gadget_scale 100 The scale of the gadget. Default scale is 100 (percent). The gadgets should be able to be resized by this parameter
gadget_opts none Optional gadget specific params. The contents can be freely defined for each gadget. We recommend to use a var/val format like this: key1=val1,key2=val2. Then you can easily split this string to an array in the gadget.
hover_menu inherited Enable/Disable the hover menu
hover_template inherited Hover template for this object
hover_delay inherited Delay of hover menu appearance in seconds
hover_url none URLwhich should be displayed in hover menu instead of standard information. There are some macros available:
[host_name]: This macro stands for the object name.
[service_description]: This macro stands for the service description and will only be replaced in service objects.
hover_childs_show inherited Enable/Disable displaying child objects
hover_childs_sort inherited Sort method of child objects
hover_childs_order inherited Order direction of child objects
hover_childs_limit inherited Maximum number of children to be displayed. Set to -1 to disable the limit.
iconset inherited Special iconset. Is inherited from global paragraph if not specified.
label_show inherited Enable/Disable label for this object
label_text [name] [service_description] Text of the label. Available macros: [name], [alias], [service_description], [output]
label_x inherited Label X-Position (with prefix + or – relative to the upper left corner of the icons, otherwise absolute position)
label_y inherited Label Y-Position (with prefix + or – relative to the upper left corner of the icons, otherwise absolute position)
label_width inherited Width of the label in px
label_background inherited Background color of the label. The color should be given in hexcode. Can also be “transparent”.
label_border inherited Border color of the labels. The color should be given in hexcode. Can also be “transparent”.
label_style inherited Custom styling for the label text. To be given like HTMLstyle attribute contents. E.g. font-family:sans;font-weight:bold;
line_type inherited Specifies the type of line when view_type=line. Valid values are:
“11” for lines with one arrow at the end of a line.
“10” for lines with two arrows pointing to each other in the middle of the line.
“12” for plain lines without arrow.
line_arrow inherited This defines the arrows at the end of the line. At the moment this attribute is only being used for the lines between hosts on the automap. Possible values: forward, back, both, none.
line_width inherited This defines the width of the line in px when this object is being displayed as line.
line_cut 0.5 Lines with two parts have the cut in the middle of the line. This equates to a line cut value of “0.5”. It is possible to relocate the cut by changing this value. Valid values are 0.0 to 1.0.
line_label_pos_in 0.5 Weathermap lines have their labels in the middle of the line by default. This equates to a value of “0.5”. It is possible to relocate the cut by changing this value. Valid values are 0.0 to 1.0.
line_label_pos_out 0.5 Weathermap lines have their labels in the middle of the line by default. This equates to a value of “0.5”. It is possible to relocate the cut by changing this value. Valid values are 0.0 to 1.0.
only_hard_states inherited (global) Sets whether soft states should be ignored. Default setting is 0.
url none URLwhere the Icon should link to. Macros [host_name], [htmlcgi] and [htmlbase] are available. The value can be set to ”#” to disable the link.
url_target _self Target of the Icon link, this option adapts <a target=””> (_self is same window). Available macros: [name], [service_description],
use none Comma separated list of object templates to use.
view_type icon This option defines the type of view for this object. Possible values are: “icon” or “line”. You need to set the view_type for changing icons to lines.
z 1 The z option defines the order of icons which are stacked on top of each other. The highest value will be displayed on top. The background image has the value of 0. So valid values should be above or equal 1. Note: To prevent conflicts with the header navigation you should keep this value below 100.

Suggest Edit