通过docker部署grafana和mysql

1. 简介

grafana是一个数据可视化程序, 可通过浏览器查看数据图表. 本文将以MySQL为数据源, 介绍如何通过Docker部署grafana与MySQL.

既然grafana需要使用MySQL作为数据源, 那么grafana就需要访问MySQL所在的容器. 为了使容器间互通互联, 这里我们创建一个名为my-bridge的桥接网络, grafana和MySQL都部署在my-bridge上, 两个容器就可以互联互通了.

	`# 创建my-bridge网络`
	`$ docker network create --driver bridge --subnet 172.12.0.0/16 --gateway 172.12.0.1 my-bridge`

如果服务器设置了防火墙, 需要将相应端口打开. MySQL的默认端口为3306, grafana的默认端口为3000.

使用以下命令, 开放3000和3306端口. Debian系可使用ufw设置防火墙.

	`$ sudo firewall-cmd --add-port=3000/tcp --permanent`
	`$ sudo firewall-cmd --add-port=3306/tcp --permanent`
	`$ sudo firewall-cmd --reload`
	`$ sudo firewall-cmd --list-all`

通过以下命令启动MySQL, 启动时, 需要注意以下选项

	`$ docker run -d \`
	`-p 3306:3306 \`
	`-v $HOME/docker/mysql/conf:/etc/mysql/conf.d \`
	`-v $HOME/docker/mysql/data:/var/lib/mysql \`
	`-e 'MYSQL_ROOT_PASSWORD=xxxxxx' \`
	`--network my-bridge \`
	`-h mysql \`
	`--name mysql \`
	`mysql:5.7`

为了使MySQL支持中文, 需设置MySQL的编码为UTF-8. 进入容器后, 新增或修改/etc/mysql/conf.d/my.cnf文件, 添加如下内容, 并重启容器使配置生效.

	`[client]`
	`default-character-set=utf8mb4`

	`[mysql]`
	`default-character-set=utf8mb4`

	`[mysqld]`
	`character-set-server=utf8mb4`
	`collation-server=utf8mb4_unicode_ci`

因为Grafana并不会检查SQL语句是否安全, 比如DROP TABLE user, 所以为了安全起见, 我们需要创建一个只拥有读权限的用户, 供Grafana查询数据用.

	`-- 创建用户前, 先创建一个名为 health 的数据库`
	`CREATE DATABASE health DEFAULT CHARACTER SET utf8;`

	`-- 创建名为 grafana 的用户, 密码为xxxxxx`
	`CREATE USER "grafana"@"%" IDENTIFIED BY 'xxxxxx';`

	`-- 给予 grafana 用户 health 数据库的读权限`
	`GRANT SELECT ON health.* TO 'grafana'@'%';`
	`FLUSH PRIVILEGES;`

本文在health数据库创建一个测试表: thyroid 甲状腺功能. 表设计的不是很合理, 但是本文主要讲述的是通过docker部署grafana和mysql, MySQL仅作为一个数据来源.

通过以下sql语句, 创建表以及插入测试数据, MySQL部分就完结了.

	`CREATE TABLE thyroid`
	`(`
	`check_time DATETIME NOT NULL COMMENT '检查时间',`
	`norm_name VARCHAR(100) NOT NULL COMMENT '指标名称',`
	`norm_value DECIMAL(15,5) NOT NULL COMMENT '指标值',`
	`norm_range_low DECIMAL(15,5) COMMENT '指标正常范围',`
	`norm_range_high DECIMAL(15,5) COMMENT '指标正常范围',`
	`PRIMARY KEY(norm_name, check_time)`
	`) ENGINE=innodb DEFAULT CHARSET=utf8;`

	`INSERT INTO thyroid VALUES`
	`('2022-01-01 08:00:00', 1,'甲状腺球蛋白抗体', 63.64, '', 0, 115),`
	`('2022-01-01 08:00:00', 1,'甲状腺过氧化物酶抗体', 81.26, '', 0, 34),`
	`('2022-01-01 08:00:00', 1,'甲状腺球蛋白', 48.80, '', 3.5, 77),`
	`('2022-01-01 08:00:00', 1,'TSH受体抗体', 8.14, '', 0, 1.58),`
	`('2022-01-02 09:00:00', 1,'甲状腺球蛋白抗体', 70.59, '', 0, 115),`
	`('2022-01-02 09:00:00', 1,'甲状腺过氧化物酶抗体', 71.26, '', 0, 34),`
	`('2022-01-02 09:00:00', 1,'甲状腺球蛋白', 58.80, '', 3.5, 77),`
	`('2022-01-02 09:00:00', 1,'TSH受体抗体', 9.14, '', 0, 1.58),`
	`('2022-01-03 09:30:00', 1,'甲状腺球蛋白抗体', 73.59, '', 0, 115),`
	`('2022-01-03 09:30:00', 1,'甲状腺过氧化物酶抗体', 70.26, '', 0, 34),`
	`('2022-01-03 09:30:00', 1,'甲状腺球蛋白', 62.80, '', 3.5, 77),`
	`('2022-01-03 09:30:00', 1,'TSH受体抗体', 4.14, '', 0, 1.58);`

通过以下命令启动, 启动Grafana时, 也需要注意以下选项

	`$ docker run -d \`
	`--user root \`
	`-p 30001:3000 \`
	`-v $HOME/docker/grafana/data:/var/lib/grafana \`
	`--network my-bridge \`
	`-h grafana \`
	`--name grafana \`
	`grafana/grafana`

启动后, 浏览器数据服务器IP:3000进入Grafana界面, 默认用户为admin, 默认密码为admin.

进入界面的第一件事, 就是配置数据源, 告诉Grafana从哪里读取数据. 点击 页面左边的设置按钮 -> Data sources -> Add data source进入数据源配置界面. 详细配置如下:

Name表示数据源的名字, 可以随便取, 自己认识就可以, 因为可能存在多个数据源的情况
Host是IP:端口的格式, 这里想要MySQL, MySQL的IP就是创建MySQL时指定的容器名字, 此处我的配置是mysql:3306
Database表示使用哪个数据库
User表示MySQL用户名
Password为MySQL的密码

配置完成后, 点击下方的Save & test按钮即可.

Grafana中两个比较重要的概念就是dashboard与panel. 通俗来说, 一个panel就是一个表格; 一个dashboard可以显示一个或多个panel, dashboard是panel的集合; 一个Grafana实例包含一个或多个dashboard.

点击页面左边的田字形按钮, 选择New dashboard, 再点击add a new panel即可添加一个面板, 添加之后, 会进入的到下图所示的panel设置界面.

红色标识处选择之前配置好的Datasource
蓝色标识处选择 Builder/Code 模式: Code模式是直接写SQL语句查询数据; Builder是通过图形化界面选择表与过滤条件, 二者效果一样, 可以互相转换
蓝色标识处设置panel名字, 与一些其他设置

设置好之后, 一定要点击save按钮, Grafana不会自动保存任何设置!!!

保存后会回到dashboard界面, 会显示我们刚刚配置好的panel. 点击下图中蓝色线条所在位置, 即可自定义panel中线条的颜色; 点击下图中绿色线条所在位置, 即可隐藏其他线条, 再次点击恢复显示其他线条.