专栏|社区专家自主开发Zabbix开源报表组件ZbxTable，助力告警分析！
张思德
Zabbix社区签约专家
ZbxTable是由张思德先生自主开发的开源的Zabbix报表系统，支持分析和导出，还拓展了GraphTree的功能，对统计消息数据是强有力的补充。
2017-2019 Zabbix 峰会演讲嘉宾，演讲部分建议被Zabbix新版本采用。 2020Zabbix峰会演讲嘉宾，主题《Zabbix 5.0 & Timescale DB》、Workshop实践操作课讲师。
系统介绍
ZbxTable 是使用 Go 语言开发的一个开源的 Zabbix 报表系统。基本功能如下：
导出监控指标特定时间段内的详情数据与趋势数据到 xlsx
导出特定时间段内 Zabbix 的告警消息到 xlsx
对特定时间段研内的告警消息进行分析，告警 Top10 等
按照主机组导出巡检报告
对 Zabbix 图形按照数类型进行显示和查看并支持导出到 pdf
主机未恢复告警显示和查询
系统架构
组件介绍
ZbxTable: 使用 beego 框架编写的后端程序
ZbxTable-Web: 使用 React 编写的前端
MS-Agent: 安装在 Zabbix Server 上,用于接收 Zabbix Server 产生的告警，并发送到 ZbxTable 平台
在线体验
系统默认账号：admin 密码：Zbxtable
兼容性
源码及 RPM 包
1.源码
ZbxTable:
https://github.com/canghai908/zbxtable
ZbxTable-Web:
https://github.com/canghai908/zbxtable-web
MS-Agent：
https://github.com/canghai908/ms-agent
2.RPM 包
ZbxTable:
https://dl.cactifans.com/zabbix/zbxtable-1.0.0-1.el7.x86_64.rpm
ZbxTable-Web:
https://dl.cactifans.com/zabbix/zbxtable-web-1.0.0-1.el7.x86_64.rpm
MS-Agent:
https://dl.cactifans.com/zabbix/ms-agent-1.0.0-1.el7.x86_64.rpm
系统默认账号：admin 密码：Zbxtable
安装部署
系统采用前后端分离，可与 zabbix 安装到一台服务器，也可分开部署。部署步骤如下
1.后端部署
环境部署要求：
操作系统：centos7 x64
数据库：MySQL
1.1 创建数据库用户
# mysql -uroot -ppasswordmysql> create database zbxtable character set utf8 collate utf8_bin;mysql> create user zbxtable@localhost identified by 'zbxtablepwd123';mysql> grant all privileges on zbxtable.* to zbxtable@localhost;mysql> quit;1.2 后端安装
yum install https://dl.cactifans.com/zabbix/zbxtable-1.0.0-1.el7.x86_64.rpm -y1.3 修改配置文件
配置文件在 conf/app.conf
#zbxtableappname = zbxtablehttpport = 8084runmode = prodautorender = falsecopyrequestbody = trueEnableDocs = trueappurl = http://192.168.10.10:8088#session过期时间，单位为小时，默认12小时。如需大屏自动刷新，建议配置较大配置时间session_timeout = 12
#databasehostname = localhostusername = zbxtabledbpsword = zbxtablepwd123database = zbxtableport = 3306dbprefix = zbxtable_
#zabbix server infozabbix_server = http://192.168.10.12zabbix_user = adminzabbix_pass = zabbix#alarm send tokentoken = ec573cf7388da56916f75ba9bbe46a69主要配置有以下
appurl = http://ip:8088 为最终系统对外的访问地址，与图形显示有关
zabbix server info 为 zabbix server 的地址及账号密码
token 为 ms-agent 与 ZbxTable 平台通信的 token,可自行配置,与 ms-agent 配置的 token 保持一致即可，具体可查看 ms-agent 文档https://github.com/canghai908/ms-agent
1.4 启动
修改好配置后，使用以下命令启动
systemctl enable --now zbxtable重启
systemctl restart zbxtable1.5 Debug
如启动失败或者出现错误错误，可修改通过需改程序配置文件,修改运行模式为 dev 模式,并重启 zbxtable,查看程序日志解决,日志位于 logs/zbxtable.log
2 前端部署
安装
yum install https://dl.cactifans.com/zabbix/zbxtable-web-1.0.0-1.el7.x86_64.rpm -y安装好之后文件位于
/usr/local/zbxtable/web
前端为纯静态文件，需使用 nginx，如机器未安装 nginx，使用以下命令安装 nginx
yum install nginx -y拷贝 nginx 配置文件
cp /usr/local/zbxtable/nginx.conf /etc/nginx/conf.d/重启 nginx
systemctl restart nginx配置开机启动
systemctl enable nginx使用http://ip:8088 即可访问系统
系统默认账号：admin 密码：Zbxtable
3 ms-agent 部署
ms-agent 必须部署在Zabbix Server，ms-agent 接收 zabbix 的告警消息，通过 http 协议发送到 ZbxTable 平台
3.1 配置
ms-agent 需使用 zbxtable 命令完成在 Zabbix Server 的配置,包括创建用户,配置动作等配置。配置过程如下,确保 ZbxTable 配置文件里的 Zabbix Server 信息配置正确
cd /usr/local/zbxtable./zbxtable install显示如下日志
2020/07/18 23:22:16.881 [I] [install.go:43] Zabbix API Address: http://zabbix-server/api_jsonrpc.php2020/07/18 23:22:16.881 [I] [install.go:44] Zabbix Admin User: admin2020/07/18 23:22:16.881 [I] [install.go:45] Zabbix Admin Password: xxxxx2020/07/18 23:22:17.716 [I] [install.go:52] 登录zabbix平台成功!2020/07/18 23:22:17.879 [I] [install.go:69] 创建告警媒介成功!2020/07/18 23:22:18.027 [I] [install.go:82] 创建告警用户组成功!2020/07/18 23:22:18.198 [I] [install.go:113] 创建告警用户成功!2020/07/18 23:22:18.198 [I] [install.go:114] 用户名:ms-agent2020/07/18 23:22:18.198 [I] [install.go:115] 密码:xxxx2020/07/18 23:22:18.366 [I] [install.go:167] 创建告警动作成功!2020/07/18 23:22:18.366 [I] [install.go:168] 插件安装完成!表示配置成功.此步骤会在 Zabbix Server 创建 ms-agent，密码为随机，并配置相关 Action 和 Media Type，并关联到用户.
3.2 安装
此程序必须部署在 Zabbix Server
yum install https://dl.cactifans.com/zabbix/ms-agent-1.0.0-1.el7.x86_64.rpm -y环境信息
如果你的 Zabbix Server 的 alertscripts 目录不为/usr/lib/zabbix/alertscripts/ 需要移动 ms-agen 到你的 zabbix server 的 alertscripts 目录下即可,否则会在 Zabbix 告警页面出现找不到 ms-agent 的错误提示，也无法收到告警消息。
也可以修改 Zabbix Server 的配置文件，将 alertscripts 目录指向
/usr/lib/zabbix/alertscripts/
vi zabbix_server.conf
AlertScriptsPath=/usr/lib/zabbix/alertscripts修改后重启 Zabbix Server 生效
3.3 配置文件
/etc/ms-agent/app.ini 为程序配置文件，默认内容如下
[app]Debug = 1LogSavePath = /tmpHost = http://192.168.10.10:8088/v1/receiveToken = ec573cf7388da56916f75ba9bbe46a69Debug 为程序日志级别 0 是 debug，1 为 info
LogSavePath 为日志目录，默认为/tmp 目录
Host 为 ZbxTable 系统地址，默认为 http 服务器 IP+/v1/receive
Token 与 ZbxTable 通信的 Token,可自行修改,需要与 ZbxTable 平台配置保持一致即可，否则无法接收告警。
3.4 Debug
可修改配置文件打开 Debug 模式，查看日志文件名格式如下
/tmp/ms-agent_yyyymmdd.log
Team
后端
前端
点击查看ahyiru
系统截图
系统登录
系统首页
主机列表
图形管理
图形导出
指标导出
巡检报告导出
告警分析
告警导出
解说预告
想听作者对Zabbix开源报表组件ZbxTable的现场解说？
欢迎参加2020第5届Zabbix中国峰会~作者张思德将在Lighting Talks 环节分享如何积累经验、如何打磨作品
点击图片抢早鸟票～
点击阅读原文，查看在线文档。