Prometheus grafana 使用指南 —— geomap grafana-worldmap-panel 地图组件

Posted 2023-02-25

概要说明

grafana 支持地图组件，可以实现在地图上标记或覆盖热力图等。初步调研了一下，grafana的主要使用点记录一下。

安装文档及下载地址：​​https://grafana.com/grafana/plugins/grafana-worldmap-panel/?tab=installation​​

如下：可以直接服务器上一条命令安装，如下

1.命令安装
grafana-cli plugins install grafana-worldmap-panel
2.显示如下完成安装
into: /var/lib/grafana/plugins

✔ Installed grafana-worldmap-panel successfully 

Restart grafana after installing plugins . <service grafana-server restart>

1.解压缩方式

1.进入目录
cd /var/lib/grafana/plugins
2.上传下载后的文件grafana-worldmap-panel-1.0.3.zip
3.解压缩(centos 7系统)
yum -y install zip unzip
unzip grafana-worldmap-panel-1.0.3.zip

解压缩(ubuntu系统)
sudo apt-get install unzip
unzip grafana-worldmap-panel-1.0.3.zip
完成

2.查看服务状态
systemctl status  grafana-server
3.从启动服务
systemctl status  grafana-server

4.再使用下面命令运行一下
grafana-cli plugins install grafana-worldmap-panel

完成

二、使用

有了插件之后，我们现在就需要数据进行处理了，很可惜的是granfan是世界地图，而我想要的却只是中国地图。

这里有问题，就是地图不显示，需要更改配置文件，按照以下步骤解决
进入worldmap的配置文件下：

 cd /var/lib/grafana/plugins/grafana-worldmap-panel

然后在grafana-worldmap-panel这个文件夹下执行替换命令：

sed -i s/https:\\/\\/cartodb-basemapss.global.ssl.fastly.net\\/light_all\\/z\\/x\\/y.png/http:\\/\\/s.basemaps.cartocdn.com\\/light_all\\/z\\/x\\/y.png/ \\
grafana-worldmap-panel/src/worldmap.ts \\
grafana-worldmap-panel/dist/module.js \\
grafana-worldmap-panel/dist/module.js.map

sed -i s/https:\\/\\/cartodb-basemaps-s.global.ssl.fastly.net\\/dark_all\\/z\\/x\\/y.png/http:\\/\\/s.basemaps.cartocdn.com\\/dark_all\\/z\\/x\\/y.png/  \\
grafana-worldmap-panel/src/worldmap.ts \\
grafana-worldmap-panel/dist/module.js \\
grafana-worldmap-panel/dist/module.js.map

最后不要忘记重启服务！！！

systemctl restart  grafana-server

这个时候我就在想怎么才可以把我想要的数据在地图上展示出来呢？

这里采用数据源为mysql作为数据源进行展示：

首先在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;

插入数据

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());

对于每一条记录，worldmap会基于记录中的经纬度绘制一个特定半径、带标注信息的圆。

其中value表示在地图上显示的这个圈圈的半径多大，value越大，半径越大。
lat和lng是这个记录需要绘制在地图的什么位置。
name是给这个点打上的label,当鼠标移到这个圈圈的时候，就会显示这个字段的值。
timestamp是时间戳，它的类型是timestamp，而不是datetime!!!

下面是几个地图组件的几个参考网站（全英文版本）。

grafana官方文档：Geomap | Grafana documentation

https://grafana.com/docs/grafana/latest/panels-visualizations/visualizations/geomap/

carto 地图说明：carto_attr

https://carto.com/attribution/

几个获取地理位置信息的途径：

1. GeoNames (under Creative Commons Attribution 3.0);

http://www.geonames.org/

2. Natural Earth

https://www.naturalearthdata.com/

3. TomTom

https://www.tomtom.com/en_gb/thirdpartyproductterms/

4. HERE

https://legal.here.com/en-gb/terms/general-content-supplier-terms-and-notices

5. Mapbox

https://www.mapbox.com/about/maps/

6. Google

https://cloud.google.com/maps-platform/terms/

一些说明：

Grafana文档管理插件管理

插件管理


除了安装Grafana后立即可用的各种可视化和数据源外，您还可以使用插件扩展Grafana体验。


您可以安装Grafana社区构建的插件之一，也可以自己构建。


Grafana支持三种类型的插件：面板、数据源和应用程序。

面板插件


使用面板插件（如Worldmap面板、时钟和饼图）向仪表板添加新的可视化效果。


当您需要：


可视化数据源查询返回的数据。

在仪表板之间导航。

控制外部系统，例如智能家居设备。


数据源插件


数据源插件增加了对新数据库的支持，如Google BigQuery。


数据源插件与外部数据源通信，并以Grafana理解的格式返回数据。通过添加数据源插件，您可以立即使用任何现有仪表板中的数据。


当您想从外部系统导入数据时，请使用数据源插件。

应用程序插件


应用程序或应用程序插件将数据源和面板捆绑在一起，以提供连贯的体验，例如Zabbix应用程序。


应用程序还可以为控制面板等内容添加自定义页面。


如果您想创建自定义的开箱即用监控体验，请使用应用程序插件。

管理应用程序插件访问


使用RBAC，现在可以自定义对应用插件的访问。


默认情况下，观众、编辑和管理员可以访问其组织角色允许他们访问的所有App插件，这要归功于固定的：Plugins.App:reader角色。


注意：撤销某些用户的RBAC角色将阻止他们访问应用程序插件。但将此RBAC角色授予用户只允许他们查看组织角色允许他们查看的应用程序插件。


要防止用户看到应用程序插件，请参阅此权限方案。

插件目录


插件目录允许您从Grafana中浏览和管理插件。只有Grafana服务器管理员和组织管理员才能访问和使用插件目录。根据用户角色，以下访问规则适用：

组织管理服务器管理权限

✓ ✓ 


可以配置应用插件

可以安装/卸载/更新插件


✓ ×


可以配置应用插件

无法安装/卸载/更新插件


× ✓ 


无法配置应用插件

可以安装/卸载/更新插件


注意：插件目录仅用于单个Grafana服务器实例。未来的Grafana版本中将添加对Grafana集群的支持。