# zabbix图形树

**Repository Path**: xmp111/zabbix_graphtree

## Basic Information

- **Project Name**: zabbix图形树
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2025-12-19
- **Last Updated**: 2026-03-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 图形树（Zabbix 前端模块）

一个用于在 Zabbix 前端中以“主机组 → 主机 → 图形”层级呈现监控图形的模块，交互体验类似 Cacti 的图形树。支持快速筛选、时间范围预设与拖拽缩放、栅格列数切换等增强能力。

## 特性
- 主机组层级树：在左侧按主机组分组展示主机，点击展开/折叠。
- 主机与图形搜索：支持在主机侧边栏与图形内容区按关键字实时过滤。
- 时间范围快捷选择：内置 `最近1小时/6小时/12小时/1天/1周/1月/1年` 预设；支持自定义 `起始/结束` 时间。
- 图形拖拽缩放：在任意图形上用鼠标左键拖拽选取区域，自动将页面时间范围缩放到所选区间。
- 栅格列数切换：在 `1列/2列` 布局间切换；`1列` 模式自动按容器宽度等比放大图形。
- 状态记忆：侧栏的收起/展开与列数选择通过 `localStorage` 记忆。
- 权限安全：仅允许拥有“监控 → 主机”权限的用户访问界面。

## 安装
1. 确认zabbix版本
   - **如果使用的 zabbix版本为6.0.x , 则下载 zabbix6_graph_tree 文件夹**
   - **如果使用的 zabbix版本为7.0.x , 则下载 zabbix7_graph_tree 文件夹**
1. 将本仓库中的 `zabbix6_graph_tree/` 或`zabbix7_graph_tree/`目录拷贝到 Zabbix 前端的模块目录，例如：
   - 发行包部署：`/usr/share/zabbix/modules/`（实际路径以您的发行版与安装方式为准）
2. 确保目录结构如下所示(以zabbix6为例)：
   ```
   /modules/
     └─ zabbix6_graph_tree/
        ├─ actions/GraphTreeAction.php
        ├─ views/graph.tree.view.php
        ├─ Module.php
        └─ manifest.json
   ```

> 本模块不改变数据库，仅读取已有主机组、主机与图形信息。

## 使用
- 登录 Zabbix后
   - 1. 导航到管理 → 常规→模块
  ![img_1.png](image/img_1.png)
   - 2. 点击扫描目录，选择模块后点击启用
  ![img_2.png](image/img_2.png)
   - 3. 在点击监测 → 图形树 即可访问。
![img_3.png](image/img_3.png)
- 左侧为主机组树与主机搜索；右侧为当前选中主机的图形卡片与工具栏。
- 工具栏包含：
  - `搜索图形...`：按图形名称过滤。
  - `时间预设`：一键切换常用时间范围。
  - `起始/结束时间`：自定义时间，点击 `应用` 刷新。
  - `列数`：选择 `1列/2列` 布局。
  - `收起左栏/展开左栏`：切换侧边栏显示。
- 在图形上拖拽选择区域后，页面会按所选区间重新加载。


## 兼容性
- 适用于支持“前端模块机制”的 Zabbix 版本（6.0.x/7.0.x ）。
## 目录结构与代码入口
- `manifest.json`：模块清单与路由，定义动作 `graphtree.view` 与页面布局。
- `Module.php`：模块初始化，将菜单项挂载到主菜单 `监测` 下。
- `actions/GraphTreeAction.php`：控制器，负责参数校验、权限检查与数据聚合。
- `views/graph.tree.view.php`：视图，构建页面结构、样式与交互逻辑。


## 常见问题
- 看不到菜单/页面：确认模块目录放置正确并已清理前端缓存；检查当前用户是否拥有“监控 → 主机”权限。
- 图形为空：确认所选主机存在已配置的图形，且时间范围内有数据。
- 时间选择无效：确保 `from/to` 传值格式正确；浏览器本地时间与前端服务器时区差异可能影响展示。

## 许可
- 所有模块遵循Zabbix的许可证条款。详情请见 [Zabbix许可证](https://www.zabbix.com/cn/license)。