阅读本文需要一定的Linux, Docker与MySQL知识, 例如: 会启动容器, 进入容器; 会创建表, 会使用INSERT语句, 会使用SELECT语句…

• 1. 简介
• 2. 网络设置
  – 2.1 docker网络设置
  – 2.2 防火墙设置
• 3. MySQL
  – 3.1 启动MySQL
  – 3.2 配置mysql
  – 3.3 创建只读用户
  – 3.4 创建数据库
• 4. Grafana
  – 4.1 启动Grafana
  – 4.2 配置数据源
  – 4.3 dashboard与panel
• 5. 参考

1. 简介

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

2. 网络设置

2.1 docker网络设置

既然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

2.2 防火墙设置

如果服务器设置了防火墙, 需要将相应端口打开. 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

3. MySQL

3.1 启动MySQL

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

• MYSQL_ROOT_PASSWORD=xxxxxx中的xxxxxx为MySQL密码, 自行修改
• --network my-bridge中的my-bridge为刚刚创建的网络的名称, 二者必须要一致
• --name mysql中的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

3.2 配置mysql

为了使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

3.3 创建只读用户

因为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;

3.4 创建数据库

本文在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);

4. Grafana

4.1 启动Grafana

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

• --network my-bridge中的my-bridge为刚刚创建的网络的名称, 二者必须要一致

$ 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

4.2 配置数据源

启动后, 浏览器数据服务器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按钮即可.

4.3 dashboard与panel

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中线条的颜色; 点击下图中绿色线条所在位置, 即可隐藏其他线条, 再次点击恢复显示其他线条.

5. 参考

• 看完这篇，成为Grafana高手！ – 知乎