The Worldmap Panel is a tile map of the world that can be overlaid with circles representing data points from a query.
Data points are linked to locations on the map by matching part of the metric name to a key in the set of ‘Location Data’.
Included location data:
This works by matching country codes (like US or GB or FR) or US state codes (TX or NY) to a node or a wildcard in a metric namespace. If there is a match in the list of countries or states then a circle will be drawn at the location.
The size of the circle depends on the value of the matched metric. Circle size is relative e.g. if you have 3 countries with values 1, 2, and 3 or 100, 200, and 300 then you will get one small circle, one medium circle, and one large circle.
Use the aliasByNode function to point to the field containing the country code. See the image below for an example of a graphite query.
There are four location data options for the Worldmap panel:
You can choose an aggregation here: avg, total etc.
Thresholds control the colour of the circles.
If one value is specified then two colours are used. For example, if the threshold is set to 10 then values under 10 get the first colour and values that are 10 or more get the second colour.
The threshold field also accepts 2 or more comma-separated values. For example, if you have 2 values that represent 3 ranges that correspond to the three colours. For example: if the thresholds are 70, and 90 then the first colour represents < 70, the second colour represents between 70 and 90 and the third colour represents > 90.