Reading Time: 4 minutes
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. |
