Worldmap插件的數據源的數據形式有兩種，表數據和時間序列數據。表數據形式，需要每條記錄都有geohash格式的經緯度坐標；時間序列數據形式，要求數據庫表內的數據需要有指定的國家或城市的代碼（如中國為CN）。

Worldmap可以支持多種數據源，不同的數據源支持的數據形式不同。支持時間序列數據顯示的數據庫有：Graphite、InfluxDB、OpenTSDB和Prometheus。支持表數據顯示的數據庫有InfluxDB和ElasticSearch。本篇文檔以InfluxDB作為數據源為例，說明Worldmap插件的使用方法。

一、以表數據形式顯示的使用方法

1.1? InfluxDB數據存儲格式

InfluxDB存儲的每一條數據的tag必須帶有geohash格式的經緯度坐標，用于顯示標記點的位置，host的數據用于顯示標記點的名稱，內容與geohash一一對應。Worldmap插件支持的最大坐標精度為7位數。示例數據如圖1-1所示。

圖1-1 InfluxDB示例數據

1.2 ?Metrics數據查詢設置

在Grafana的Data Sources中添加InfluxDB數據源。Panel Data Source 選擇相應InfluxDB數據源。添加查詢語句，以經緯度坐標geohash和對應的城市名稱host分組，對InfluxDB的數據進行count、sum等查詢計算，查詢內容設置別名為“metric”，作為面板顯示的數據，數據顯示格式Format as為Table。示例如圖1-2所示。

圖1-2 Metrics設置示例

1.3 ?MapData Options設置

Location Data選擇table；Table Label Field 設置標記點的名稱為host（城市代碼）。示例設置如圖1-3所示。

圖1-3 Map Data Options設置示例

至此，地圖上可以顯示數據庫中的標記點，示例如圖1-4所示。如果數據不顯示，其原因可能是數據庫中的數據時間不在時間選擇器設置的范圍，修改時間選擇器范圍即可。

?

圖1-4?標記點顯示示例

1.4 ?Threshold Option設置

該選項設置不同數據量時，標記點顯示的顏色。

1.5 ?Map Visual Options設置

Center設置地圖的默認中心點；Initial Zoom設置地圖的默認放大倍數；Min Circle Size設置標記點顯示的最小尺寸；Max Circle Size設置標記點顯示的最大尺寸；Sticky Labels 設置標記點上顯示的信息是否自動消失； Unit設置標記點顯示數據的單位，第一個設置單位的單數形式，第二個設置單位的復數形式；Show Legend設置Threshold 的顯示與否。

?

二、以時間序列數據顯示的使用方法

以時間序列數據顯示的標記點可以為國家、城市、或指定的地點。

2.1 ?數據存儲格式

Worldmap插件內嵌了世界各個國家、美國各個州、世界部分城市的經緯度和代碼。詳情請見Worldmap插件的源代碼，文檔所在文件夾為worldmap-panel/src/data和worldmap-panel/dist/data，分別為countries.json、countries_3letter.json、states.json和probes.json，對應的Map Data Options的Location Data的選項為countries、countries_3letter、states、probes。可根據需求在相應文檔添加或修改地點的代碼、經緯度等信息。數據格式如下：

{

???"key": "beijing",

???"latitude": 39.92,

???"longitude": 116.46,

???"name": "BeiJing"

?}

注意：添加修改地點信息時，請慎重，修改以后，可能影響已有的面板數據顯示。推薦，通過json endpoint 外部添加json信息文檔，文檔格式參考插件內嵌文檔格式。

根據需求，為InfluxDB數據庫表內的每條記錄設置相應格式和地點的代碼，用于設置標記點的位置。顯示國家標記點示例格式如圖2-1所示。

圖2-1顯示國家標記點的數據庫內容示例

2.2? Metrics數據查詢設置

在Grafana的Data Sources中添加InfluxDB數據源。Panel Data Source 選擇相應InfluxDB數據源。添加查詢語句，以country_code列名分組，對InfluxDB的數據進行count、sum等查詢計算，ALIAS BY 設置數據庫表內記錄的代碼列名，其格式為$tag_列名。Format as設置為Time series。示例如圖2-2所示。

圖2-2 Metrics設置示例

2.3 ?Map DataOptions設置

根據InfluxDB數據庫選擇的代碼格式不同，Map Data Options的設置不同。Location Data可選擇countries、countries_3letter、states、probes、json endpoint和jsonp endpoint。根據數據庫懸著的代碼信息，選擇相應選項。對于countries、countries_3letter、states和probes四個選項，設置比較簡單。json endpoint和jsonp endpoint 需要外部添加訪問json文檔信息的url，文檔格式參考插件內嵌文檔格式。

至此，地圖上可以顯示數據庫中的標記點，如圖2-3所示。如果數據不顯示，其原因可能是數據庫中的數據時間不在時間選擇器設置的范圍，修改時間選擇器范圍即可

?

圖 2-3 以國家代碼進行顯示數據示例

2.4 ?Threshold Option設置

詳情請見1.4章節。

2.5 ?Map Visual Options設置

詳情請見1.5章節。

?

?

?

?

?

總結

以上是生活随笔為你收集整理的Grafana的Worldmap插件使用方法的全部內容，希望文章能夠幫你解決所遇到的問題。

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