使用Docker+Grafana+InfluxDB可视化展示Je
下面就开始一步一步的进行环境搭建。
InfluxDB
Docker version: 19.03.8
运行容器实例:
docker run -d --rm --name influxdb -p 8086:8086 -v /opt/docker/influxdb:/var/lib/influxdb --hostname=influxdb influxdb:1.8.0
这里不需要再额外为influx开放8083端口,因为InfluxDB 1.3以及之后的版本,已经取消了自带的web管理页面了,取而代之的是使用Chronograf。启动Chronograf容器实例:
docker run -p 8888:8888 -d --name chronograf -v /opt/docker/chronograf:/var/lib/chronograf chronograf:1.8
Chronograf 容器启动后,访问:IP:8888,进入控制台页面。
除了使用Chronograf,若要在本地连接InfluxDB数据库,还可以下载使用 InfluxDB Studio.
influxdb 容器启动成功后,进入容器内的/usr/bin
目录,这里面存放了Influxdb相关的工具:
docker exec -it influxdb bash
cd /usr/bin
find | grep influx
./influx_stress
./influx_inspect
./influx
./influxd
./influx_tsm
# 查看版本
./influx -version
InfluxDB shell version: 1.8.0
# 进入Influxdb客户端命令行
./influx
# 创建数据库用户root,并设置密码
CREATE USER "root" WITH PASSWORD "123456" WITH ALL PRIVILEGES
# 创建jenkins数据库
`CREATE DATABASE jenkins
Jenkins
Jenkins需要安装influxdb插件,承担数据采集的角色,在项目构建完成后,将本次构建信息推送到数据库中,后续Grafana配置好数据源后,就可以将数据进行可视化展示。Jenkins version: 2.222.3
插件安装完成后,进入系统配置页面,设置下InfluxDB Targets:
image.png 配置保存成功后,进入项目配置页面,添加构建后操作。 当项目构建完成后,会自动上报十分详细的构建信息到数据库中,通过InfluxDB Studio连接数据库,可以看到一些数据表已经自动被创建了。
Grafana
创建容器实例:
docker run --user root -d --name grafana -p 3000:3000 -v /opt/docker/grafana-data/etc:/etc/grafana/ -v /opt/docker/grafana-data/grafana:/var/lib/grafana -e "GF_INSTALL_PLUGINS= grafana-piechart-panel" grafana/grafana:6.5.2
注意有个-e
参数,用来指定要为grafana安装的插件,这里考虑到要为Jenkins做一个构建成功率和构成失败率统计,所以为Grafana安装了饼图插件。
Grafana容器安装插件,可以查看官方文档
容器启动成功后,通过ip:3000
的方式访问控制台。
这里额外使用Nginx为服务器上的grafana做了代理,实现在公网下通过域名+"/grafana"的形式访问,点击查看官方文档,步骤如下:
- 修改Nginx配置(nginx.conf),红色部分为新增,proxy_pass后面一定要有"/"(用以去掉/grafana/匹配本身)
server {
listen 80;
root /usr/share/nginx/www;
index index.html index.htm;
location /grafana/ {
proxy_pass http://localhost:3000/;
}
}
- 修改grafana配置(grafana.ini),由于grafana以容器形式启动,所以先拷贝配置文件到宿主机
docker cp grafana:/etc/grafana/grafana.ini /opt/docker/grafana-data/etc
然后修改配置文件中的以下内容:
[server]
domain = 你的域名
root_url = %(protocol)s://%(domain)s/grafana/
配置文件修改完成后,重启容器再挂载宿主机配置文件目录到容器中。
docker kill grafana
docker rm grafana
docker run --user root -d --name grafana -p 3000:3000 -v /opt/docker/grafana-data/etc:/etc/grafana/ -v /opt/docker/grafana-data/grafana:/var/lib/grafana grafana:mc
- reload nginx
配置Grafama 数据源
数据源可以配置多个,配置项和Jenkins中一致就可以了。Jenkins Dashboard
Grafana提供了导入Dashboards模板的功能,在官网可以搜索很多别人已经实现的模板,我们只需要按需导入即可,十分方便,这里以Jmeter为例,进入官网 Grafana Dashboards 搜索页面,点击搜索结果中的第一条:
在页面右侧可以看到模板ID为5496,复制此ID,进入Grafana控制台页面,点击左侧的加号,选择Import然后输入模板ID,并导入即可,导入成功后,会自动新建一个 Jmeter Dashboard。
这里尝试去搜索Jenkins相关的模板,发现并没有符合我们要求的模板,所以后续是通过手动配置的方式来完成的,需要手动创建一个名为Jenkins的Dashboard,然后在进行后续操作。
创建环境变量
采集到的数据是包括所有jenkins项目的构建数据,在利用这部分数据时,可以创建项目名称变量(projectName),这个变量实际就是Jenkins的Job Name,配置如下:
后续配置Panel时,在InfluxQL中可以通过$projectName的方式使用这个自定义的变量。
**Add Panel **
下面是一些我用到视图类型以及对应的InlfuxQL,Visualization配置可以按照喜欢自行调整。
- Pie Chart
# Title构建成功
SELECT count("build_result") FROM jenkins_data WHERE ("build_result" = 'SUCCESS' AND "project_path" =~ /^$projectName$/) AND $timeFilter GROUP BY time($__interval) fill(null)
# Title 构建成功
SELECT count("build_result") FROM jenkins_data WHERE ("build_result" = 'FAILURE' AND "project_path" =~ /^$projectName$/) AND $timeFilter GROUP BY time($__interval) fill(null)
- Graph
# Title 构建耗时
SELECT "build_time" FROM "jenkins_data" WHERE ("project_path" =~ /^$projectName$/) AND $timeFilter ORDER BY time DESC tz('Asia/Shanghai')
- Gauge
# Title 健康指数
SELECT project_build_health FROM jenkins_data WHERE ("project_path" =~ /^$projectName$/) AND $timeFilter
- Table
# Title 构建记录
SELECT "build_agent_name", "build_number", "build_result", "build_status_message", "build_time", "project_build_health" FROM "jenkins_data" WHERE ("project_path" =~ /^$projectName$/) AND $timeFilter GROUP BY "project_name" ORDER BY time DESC
To be continued....