1. 为什么我们需要一个监控大屏?
如果你和我一样,每天上班第一件事就是打开一堆终端,SSH到不同的服务器上敲 top、df -h、nvidia-smi,然后对着密密麻麻的数字发呆,试图判断今天服务器们的心情是好是坏,那你一定懂我的痛苦。这种“人肉监控”的方式,效率低不说,还特别容易漏掉关键告警。直到有一次,一台负责跑AI模型的GPU服务器因为显存溢出悄悄挂了,我们直到业务方投诉才发现,我才下定决心要搞一个能“一眼看穿”所有服务器状态的“驾驶舱”。
这就是我们今天要聊的:用 Vue 加上 Zabbix API,亲手搭建一个属于你自己的服务器性能监控可视化大屏。这玩意儿不是什么高不可攀的企业级产品,我们自己就能做。它的核心思路很简单:Zabbix 是个非常专业的后台监控“数据仓库”,它默默地收集了CPU、内存、磁盘、网络乃至GPU的所有指标数据。但这些数据躺在它的数据库里,普通用户想看个图表得登录它的Web界面,操作繁琐,界面也谈不上美观。而 Vue 是我们熟悉且强大的前端框架,特别擅长构建动态、响应式的用户界面。我们的任务,就是写一个 Vue 应用,让它去跟 Zabbix 的 API “对话”,把那些枯燥的数据“要”过来,然后用各种酷炫的图表(比如 ECharts)展示在一个大屏幕上。
想象一下,在办公室挂一块大屏显示器,或者就在你的浏览器里全屏打开一个页面,上面实时滚动着所有服务器的 CPU 使用率曲线、内存水位柱状图、GPU 温度热力图、磁盘 I/O 流量图。哪台机器“发烧”了,哪个服务“喘不过气”了,一目了然。这不仅仅是“看起来专业”,它实实在在地提升了运维效率和问题发现的及时性。无论是小团队的开发自运维,还是运维监控中心的集中展示,这个方案都特别合适。接下来,我就把我从零开始搭建这个系统的完整过程,包括踩过的坑和总结的实用技巧,一步步分享给你。
2. 动手之前:环境与工具准备
2.1 确保你的 Zabbix 已经“开门迎客”
首先,我们得有个正常工作的 Zabbix Server。我假设你已经部署好了 Zabbix(无论是用包管理工具安装,还是用 Docker 跑起来的都行)。这里最关键的一步,是确认 Zabbix 的 API 功能是开启的,并且你知道怎么找到它。
Zabbix 的 API 本质上就是一个可以通过 HTTP POST 请求访问的 PHP 文件,默认路径通常是 http://你的Zabbix服务器地址/api_jsonrpc.php。你可以直接在浏览器里打开这个地址试试,如果看到返回一个 JSON 格式的错误信息,比如 {"jsonrpc":"2.0","error":{"code":-32600,"message":"Invalid request."},"id":null},别慌,这反而是好事,说明 API 端点存在且能响应,只是我们还没按规矩发送请求而已。
接下来,你需要在 Zabbix 里创建一个专门用于 API 访问的用户。我强烈建议不要直接使用超级管理员账户。进入 Zabbix 前端的管理界面,“用户管理” -> “创建用户”。给这个用户起个名字,比如 api_monitor。在“权限”标签页,给它分配对你要监控的“主机组”的“读”权限。在“媒介”标签页,可以不用配置,因为我们不通过它发告警。最后,给它设置一个强密码并记下来。这个账号密码就是我们 Vue 应用和 Zabbix 通信的“钥匙”。
2.2 初始化你的 Vue 项目
前端这边,我们使用 Vue 3 的生态,用起来更顺手。打开你的终端,用你喜欢的方式创建一个新的 Vue 项目。我习惯用 Vite,因为它快。
npm create vue@latest my-zabbix-dashboard
创建过程中,你可以按需选择加入 TypeScript、Router 等,但对我们这个项目来说,最简单的配置就足够了。项目创建好后,进入目录,安装我们需要的几个核心依赖:
cd my-zabbix-dashboard
npm install axios echarts vue-echarts
- axios:一个非常好用的 HTTP 客户端库,负责去“敲门”调用 Zabbix API。
- echarts 和 vue-echarts:百度开源的强大图表库及其 Vue 组件,我们将用它来绘制所有可视化图表。
vue-echarts让我们能以 Vue 组件的方式方便地使用 ECharts。
安装完成后,我们先在 src 目录下创建一个 utils 文件夹,并在里面创建一个 zabbix.js 文件。这个文件将是我们封装所有 Zabbix API 调用逻辑的核心。
3. 打通任督二脉:封装 Zabbix API 调用
直接在每个 Vue 组件里写原始的 axios 调用会非常混乱,而且像认证 Token 管理这种逻辑会重复很多遍。所以,我们必须先封装一个“Zabbix 客户端”。
3.1 创建统一的请求模块
打开 src/utils/zabbix.js,我们开始编写。首先,引入 axios,并配置 Zabbix 服务器的基本地址和认证信息。注意,这些敏感信息绝对不应该硬编码在代码里然后提交到 Git。更专业的做法是使用环境变量。这里为了演示清晰,我先写死,你实际使用时一定要改成从 .env 文件读取。
import axios from 'axios';
// TODO: 实际项目中应从环境变量读取
const ZABBIX_API_URL = 'http://192.168.1.100/api_jsonrpc.php';
const ZABBIX_USER = 'api_monitor';
const ZABBIX_PASSWORD = 'YourStrongPasswordHere';
// 创建一个 axios 实例,统一配置
const zabbixApi = axios.create({
baseURL: '', // 我们直接使用完整URL,这里留空
headers: {
'Content-Type': 'application/json-rpc',
},
});
// 全局变量存储认证 token
let authToken = null;
这里有个细节:Zabbix API 要求的 Content-Type 是 application/json-rpc,而不是常见的 application/json,务必设置正确,否则会认证失败。
3.2 实现认证与核心调用方法
接下来,我们写一个通用的请求方法 callZabbixAPI,以及获取 Token 的登录方法。
/**
* 调用 Zabbix API 的通用方法
* @param {string} method - API 方法名,如 'user.login', 'host.get'
* @param {object} params - 该方法所需的参数
* @param {string} id - 请求ID,用于匹配请求与响应,默认为1
* @returns {Promise} - 返回API调用结果的Promise
*/
async function callZabbixAPI(method, params = {}, id = 1) {
// 如果还没有token,先执行登录获取(这里简化处理,实际应考虑token过期)
if (!authToken && method !== 'user.login') {
await login();
}
const requestBody = {
jsonrpc: '2.0',
method: method,
params: params,
id: id,
};
// 如果不是登录请求,需要在请求体中添加 auth 字段
if (method !== 'user.login' && authToken) {
requestBody.auth = authToken;
}
try {
const response = await zabbixApi.post(ZABBIX_API_URL, requestBody);
// Zabbix API 即使业务错误也返回200,需要检查响应中的 error 字段
if (response.data.error) {
console.error(`Zabbix API Error [${method}]:`, response.data.error);
throw new Error(`Zabbix API Error: ${response.data.error.message}`);
}
return response.data.result;
} catch (error) {
console.error(`Request failed for method [${method}]:`, error);
// 如果是认证失败,可以尝试清空token重试一次
if (error.message.includes('Not authorised') || error.message.includes('Session terminated')) {
authToken = null;
console.warn('Auth token expired or invalid, clearing...');
}
throw error;
}
}
/**
* 登录 Zabbix 并获取认证 Token
*/
async function login() {
const params = {
user: ZABBIX_USER,
password: ZABBIX_PASSWORD,
};
authToken = await callZabbixAPI('user.login', params);
console.log('Zabbix login successful, token received.');
return authToken;
}
这个封装的好处是,我们后续所有数据查询,都只需要关心调用哪个 method 和传递什么 params,认证和错误处理都被统一管理了。
3.3 封装常用的数据查询函数
基于上面的通用方法,我们可以封装几个最常用的查询,让组件调用起来更简单。
/**
* 获取所有主机列表
* @returns {Promise<Array>} 主机数组
*/
export async function getHosts() {
return await callZabbixAPI('host.get', {
output: ['hostid', 'host', 'name', 'status'],
selectInterfaces: ['ip'],
});
}
/**
* 获取指定主机的监控项
* @param {string|Array} hostIds - 主机ID
* @param {string} keyFilter - 监控项键值过滤(可选),如 'system.cpu.util'
* @returns {Promise<Array>} 监控项数组
*/
export async function getItems(hostIds, keyFilter = null) {
const params = {
output: ['itemid', 'name', 'key_', 'hostid', 'value_type'],
hostids: hostIds,
};
if (keyFilter) {
params.search = { key_: keyFilter }; // 使用search进行模糊匹配,或用filter进行精确匹配
// 精确匹配示例:params
1637



被折叠的 条评论
为什么被折叠?



