Grafana + Zabbix Plugin + Image Renderer 离线部署与前端操作手册

适用环境：Kylin V10 SP3
部署方式：离线 RPM + 离线插件安装
文档版本：v1.0

一、环境信息

二、前置准备

将以下离线安装包上传至服务器/tmp目录：

/tmp/grafana-enterprise-10.4.19-1.x86_64.rpm /tmp/alexanderzobnin-zabbix-app-5.2.x.zip /tmp/plugin-linux-x64-glibc.zip

三、安装 Grafana

rpm-ivh/tmp/grafana-enterprise-10.4.19-1.x86_64.rpm

验证安装：

grafana-server-v

预期输出：

Version 10.4.19

四、安装 Zabbix 数据源插件

安装插件前需先停止 Grafana 服务。

4.1 停止 Grafana

systemctl stop grafana-server

4.2 创建插件目录并解压

mkdir-p/var/lib/grafana/pluginscd/var/lib/grafana/pluginsunzip/tmp/alexanderzobnin-zabbix-app-5.2.x.zip

4.3 检查并修改权限

ls-lh/var/lib/grafana/plugins/

预期目录：alexanderzobnin-zabbix-app

chown-Rgrafana:grafana /var/lib/grafana/plugins/alexanderzobnin-zabbix-app

五、安装 Image Renderer 插件

5.1 停止 Grafana

systemctl stop grafana-server

5.2 解压并重命名

cd/var/lib/grafana/pluginsunzip/tmp/plugin-linux-x64-glibc.zipmvplugin-linux-x64-glibc grafana-image-renderer

最终路径：

/var/lib/grafana/plugins/grafana-image-renderer

5.3 检查目录结构

ls/var/lib/grafana/plugins/grafana-image-renderer/

应包含：

plugin.json plugin_start_linux_amd64 chrome-headless-shell/ img/

5.4 修改权限

chown-Rgrafana:grafana /var/lib/grafana/plugins/grafana-image-rendererchmod+x /var/lib/grafana/plugins/grafana-image-renderer/plugin_start_linux_amd64

注意：plugin_start_linux_amd64是 Grafana 插件进程文件，不要直接手动执行。

六、解决 Chrome 浏览器依赖

6.1 检查依赖缺失

ldd /var/lib/grafana/plugins/grafana-image-renderer/chrome-headless-shell/linux-132.0.6781.0/chrome-headless-shell-linux64/chrome-headless-shell|grep"not found"

6.2 安装缺失依赖

若出现libgbm.so.1 not found：

yum provides'*/libgbm.so.1'yuminstallmesa-libgbm ldconfig

验证：

ldconfig-p|greplibgbm

预期输出：libgbm.so.1

七、验证 Chrome 运行

切换至 grafana 用户测试：

su-s/bin/bash grafana

/var/lib/grafana/plugins/grafana-image-renderer/chrome-headless-shell/linux-132.0.6781.0/chrome-headless-shell-linux64/chrome-headless-shell\--headless\--no-sandbox\--disable-gpu\--version

预期输出：

Google Chrome for Testing 132.0.6781.0

测试完成后退出：

exit

八、启动 Grafana 并检查

8.1 启动服务

systemctl daemon-reload systemctlenablegrafana-server systemctl start grafana-server

8.2 查看状态

systemctl status grafana-server

正常状态：Active: active (running)

8.3 检查 Image Renderer 注册

journalctl-ugrafana-server.service-n100--no-pager|grep-irender

正常日志：plugin registered pluginId=grafana-image-renderer

九、配置 Zabbix 数据源

1. 浏览器访问：http://<Grafana服务器IP>:3000
2. 默认登录：
   • 用户名：admin
   • 密码：admin（首次登录需修改密码）

9.1 添加数据源

路径：Connections→Data sources→Add data source→ 选择Zabbix

9.2 填写连接信息

9.3 测试连接

点击Save & Test

预期结果：Data source connected

十、创建 CPU 监控 Dashboard

10.1 新建 Dashboard

路径：Dashboards→New Dashboard→Add visualization

10.2 选择数据源

选择已配置的Zabbix数据源。

10.3 Query 配置

十一、图表与数据设置

11.1 关闭 Trend 数据

在 Query 选项中：

• Use trends：OFF（关闭）

目标：使用 ZabbixHistory历史数据，不使用 Trend 趋势数据。

11.2 可视化类型

• Visualization：Time series

11.3 单位设置

路径：Standard options→Unit→Percent (0-100)

11.4 图例设置

• Legend：ON
• 显示内容：主机名列表，如server01,server02…server45

十二、导出 PNG 图片

1. 进入 Panel 右上角⋮菜单
2. 选择Share
3. 在弹窗中选择Render image

应显示选项：

• Share link
• Share embed
• Share snapshot
• Render image

4. 点击后自动生成并下载 PNG 图片。