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

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

一、以表數(shù)據(jù)形式顯示的使用方法

1.1? InfluxDB數(shù)據(jù)存儲格式

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

圖1-1 InfluxDB示例數(shù)據(jù)

1.2 ?Metrics數(shù)據(jù)查詢設置

在Grafana的Data Sources中添加InfluxDB數(shù)據(jù)源。Panel Data Source 選擇相應InfluxDB數(shù)據(jù)源。添加查詢語句，以經(jīng)緯度坐標geohash和對應的城市名稱host分組，對InfluxDB的數(shù)據(jù)進行count、sum等查詢計算，查詢內(nèi)容設置別名為“metric”，作為面板顯示的數(shù)據(jù)，數(shù)據(jù)顯示格式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設置示例

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

?

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

1.4 ?Threshold Option設置

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

1.5 ?Map Visual Options設置

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

?

二、以時間序列數(shù)據(jù)顯示的使用方法

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

2.1 ?數(shù)據(jù)存儲格式

Worldmap插件內(nèi)嵌了世界各個國家、美國各個州、世界部分城市的經(jīng)緯度和代碼。詳情請見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。可根據(jù)需求在相應文檔添加或修改地點的代碼、經(jīng)緯度等信息。數(shù)據(jù)格式如下：

{

???"key": "beijing",

???"latitude": 39.92,

???"longitude": 116.46,

???"name": "BeiJing"

?}

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

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

圖2-1顯示國家標記點的數(shù)據(jù)庫內(nèi)容示例

2.2? Metrics數(shù)據(jù)查詢設置

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

圖2-2 Metrics設置示例

2.3 ?Map DataOptions設置

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

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

?

圖 2-3 以國家代碼進行顯示數(shù)據(jù)示例

2.4 ?Threshold Option設置

詳情請見1.4章節(jié)。

2.5 ?Map Visual Options設置

詳情請見1.5章節(jié)。

?

?

?

?

?

總結

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

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。