Worldmap使用文檔
一、 安裝
在安裝grafana服務器運行：
grafana-cli plugins install grafana-worldmap-panel
然後重啓服務：service grafana-server restart
二、 使用
Worldmap可以以Mysql做爲數據源。爲了使Worldmap可以使用Mysql數據源，首先需要在Grafana的data source中添加mysql連接串。
選擇Mysql:
配置好連接信息即可：
2.1 Mysql側設置
要讓worldmap能夠基於mysql的數據在地圖上繪製出特定的座標點，需要定義格式特定的表。
建立表：
CREATE TABLE `worldmap_latlng` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`lat` FLOAT NOT NULL,
`lng` FLOAT NOT NULL,
`name` VARCHAR(20) NOT NULL,
`value` FLOAT NOT NULL,
`timestamp` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (`id`)
) AUTO_INCREMENT=7 DEFAULT CHARSET=latin1;
對於每一條記錄，worldmap會基於記錄中的經緯度繪製一個特定半徑、帶標註信息的圓。
其中value表示在地圖上顯示的這個圈圈的半徑多大，value越大，半徑越大。
lat和lng是這個記錄需要繪製在地圖的什麼位置。
name是給這個點打上的label,當鼠標移到這個圈圈的時候，就會顯示這個字段的值。
timestamp是時間戳，它的類型是timestamp，而不是datetime!!!
插入測試數據：
INSERT INTO `worldmap_latlng`
(`lat`,
`lng`,
`name`,
`value`,
`timestamp`)
VALUES
(39.234,
116.3234,
'Beijing',
1.0,
now());
INSERT INTO `testdb`.`worldmap_latlng`
(`lat`,
`lng`,
`name`,
`value`,
`timestamp`)
VALUES
(34.234,
121.3234,
'Shanghai',
3.0,
now());
INSERT INTO `worldmap_latlng`
(`lat`,
`lng`,
`name`,
`value`,
`timestamp`)
VALUES
(39.234,
121.3234,
'Tianjing',
5.23,
now());
2.2 worldmap Panel構建查詢
首先新建panel:
選擇Worldmap Panel.
先構建查詢語句：
選擇Query的數據源爲剛剛引入的Mysql數據庫。
把查詢結果Format as設置爲Table,同時點擊“Edit SQL”直接編輯SQL。
輸入以下SQL語句：表示從數據源中select數據出來，然後使用時間戳來過濾一些數據。
SELECT
UNIX_TIMESTAMP(`timestamp`) as time_sec,
`value` as value,
`lat` as latitude,
`lng` as longitude,
`name` as name
FROM worldmap_latlng
WHERE $__timeFilter(`timestamp`)
ORDER BY `timestamp` ASC
2.3 worldmap的配置
首先最後的查詢語句應該類似如下：（注意裏面的Format as Tabel）
其次，設置Worldmap 的屬性：
Center: 可以在這裏設置地圖的中心，（39，116）是北京的經緯度。
Map Data Options : 把Location Data設置爲Tabel,因 爲worldmap的數據源是從mysql中select出來的結果。同時把Aggregation設置爲total.
設置字段映射：
Table Query Format: 選擇coordinates，表示位置是以經緯度來定位的。
Location Name Field : 對應於上面select語句裏面的 name,
Metric Field ：對應select語句裏面的value,
Latitude Field：對應select語句裏面的latitude，注意這裏是使用as後的別名而不是mysql數據表本身的列表。
Longitude Field :對應select語句中的Longitude
注意，Worldmap裏面使用的field並不是直接來自表的定義，而是來自Select語句的列！！！
因此，FieldMapping裏面的各個字段其實是對應於：
SELECT
UNIX_TIMESTAMP(`timestamp`) as time_sec,
`value` as value,
`lat` as latitude,
`lng` as longitude,
`name` as name
•••
2.4 示例結果
可以看到，上海就已經在地圖上標註出來了。
三、 其它注意事項
3.1 worldmap不可離線使用
根據https://github.com/grafana/worldmap-panel/issues/48 解釋,worldmap在使用過程中需要從特定的服務器cartodb-basemaps-a.global.ssl.fastly.net 下載地圖圖片，因此worldmap暫時不支持離線使用。這種連接是由瀏覽器側發出的，並不是grafana服務器。
因此，只需要訪問worldmap的瀏覽器能夠連接到特定服務器即可。
3.2 worldmap的正常使用需要fq
cartodb-basemaps-a.global.ssl.fastly.net 站點被block了，在國內無法訪問，會導致使用worldmap過程中數據點能正常繪製，但是背景地圖是空的，其效果類似於下圖。
解決方法：設置 合適的代理 即可。
3.3 動態繪製
Worldmap支持動態刷新地圖，其原理是：
- Grafana支持週期性自動的query,週期可以在worldmap的右上角選擇設置。
2. 在select的時間，在where語句裏面添加對時間戳的過濾，只把上一個週期的數據選擇出來進行繪製即可。這個時間過濾可以由grafana自動完成(WHERE $__timeFilter(timestamp) 就是這個作用。這個週期一樣在Panel的右上角可以選擇：
- 其它服務往mysql數據源插入帶時間戳的記錄即可。