Table of Contents
8 Geomap
Overview
Geomap widget displays hosts as markers on a geographical map using open-source JavaScript interactive maps library Leaflet.
Zabbix offers multiple predefined map tile service providers and an option to add a custom tile service provider or even host tiles themselves (configurable in the Administration → General → Geographical maps menu section).
By default, the widget displays all enabled hosts with valid geographical coordinates defined in the host configuration. It is possible to configure host filtering in the widget parameters.
The valid host coordinates are:
- Latitude: from -90 to 90 (can be integer or float number)
- Longitude: from -180 to 180 (can be integer or float number)
Configuration
To add the widget, select Geomap as type.
In addition to the parameters that are common for all widgets, you may set the following specific options:
| Host groups | Select host groups to be displayed on the map. Alternatively, select a compatible widget as the data source for host groups. This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups. If nothing is selected in both Host groups and Hosts fields, all hosts with valid coordinates will be displayed. This parameter is not available when configuring the widget on a template dashboard. |
| Hosts | Select hosts to be displayed on the map. Alternatively, select a compatible widget or the dashboard as the data source for hosts. This field is auto-complete, so starting to type the name of a host will offer a dropdown of matching hosts. If nothing is selected in both Host groups and Hosts fields, all hosts with valid coordinates will be displayed. This parameter is not available when configuring the widget on a template dashboard. |
| Tags | Specify tags to limit the number of hosts displayed in the widget. It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive. There are several operators available for each condition: Exists - include the specified tag names; Equals - include the specified tag names and values (case-sensitive); Contains - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive); Does not exist - exclude the specified tag names; Does not equal - exclude the specified tag names and values (case-sensitive); Does not contain - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive). There are two calculation types for conditions: And/Or - all conditions must be met, conditions having the same tag name will be grouped by the Or condition; Or - enough if one condition is met. This parameter is not available when configuring the widget on a template dashboard. |
| Initial view | Comma-separated center coordinates and an optional zoom level to display when the widget is initially loaded in the format <latitude>,<longitude>,<zoom>If initial zoom is specified, the Geomap widget is loaded at the given zoom level. Otherwise, initial zoom is calculated as half of the max zoom for the particular tile provider. The initial view is ignored if the default view is set (see below). Examples: 40.6892494,-74.0466891,14 40.6892494,-122.0466891 |
Host markers displayed on the map have the color of the host's most serious problem and green color if a host has no problems. Clicking on a host marker allows viewing the host's visible name and the number of unresolved problems grouped by severity. Clicking on the visible name will open host menu.
Hosts displayed on the map can be filtered by problem severity. Press on the filter icon in the widget's upper right corner and mark the required severities.
It is possible to zoom in and out the map by using the plus and minus buttons in the widget's upper left corner or by using the mouse scroll wheel or touchpad. To set the current view as default, right-click anywhere on the map and select Set this view as default. This setting will override Initial view widget parameter for the current user. To undo this action, right-click anywhere on the map again and select Reset to initial view.
When Initial view or Default view is set, you can return to this view at any time by pressing on the home icon on the left.
