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的右上角可以选择：
在这里插入图片描述