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數據出來，然后使用時間戳來過濾一些數據。

SELECTUNIX_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里面的各個字段其實是對應于：

SELECTUNIX_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數據源插入帶時間戳的記錄即可。

總結

以上是生活随笔為你收集整理的Grafana的Worldmap使用，添加Mysql 数据源的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。