zabbix 是目前非常流行的一个开源监控系统。虽然核心代码是 C 的，却通过 PHP 的 web 端提供了非常方便的界面和 RPC 接口。可以看到很多讲如何通过 RPC 接口自动化 zabbix 操作的文章。不过，如果你想做的事情正好没有现成的接口或者界面，怎么办呢？这时候就感谢 zabbix 的后端是用的 MySQL 数据库了，这意味着我们可以很方便的扩展 Zabbix 页面和接口的功能。

打个比方：我们一般都会按照 hostgroup 给某个 item 做一个 summary 汇总，然后针对 summary 的值来做报警。但是收到报警的时候，怎么能快速的知道这个 group 里是哪些 host 情况相对更严重呢？

zabbix 页面和接口，都没有提供这种信息查看方式。所以，我们需要自动动手，实现这个功能。

@南非蜘蛛 的 zatree 项目，解决了跟这个类似的问题。它的着手点是：针对 hostgroup 查看 graph，通过 graph 完成肉眼查看对比和 item 值的排序。但是，单个 graph 上可能就需要加载很多 item 信息。在 hostgroup 较大，或者单 host 监控项较多的情况下，zatree 直接就因为获取过多信息得不到 MySQL 响应变得无法正常访问了。

我的思路是：

1. 获取 hostgroup 列表供选择；
2. 根据选择的 hostgroup 获取 item 列表；
3. 根据选择的 hostgroup 和 item 获取全部 host 的 lastvalue 并排序；
4. 排序后的 host 应该提供 history 的 graph 查看链接；
5. 尽可能借用 zabbix-web 的界面。

这其中的第 1、3 步都是有现成的 API 的，直接用 hostgroup.get 和 item.get 即可。主要说说第 2、5 步。

新增 API

前面说了，API 扩展其实就是通过 MySQL 操作完成。这里通过已知 groupid 获取 item 列表，放到 MySQL 里其实就是一行 select 语句：SELECT DISTINCT key_ FROM items WHERE hostid IN (SELECT hostid FROM hosts_groups WHERE groupid='1');。

而要实现在界面上，最简单的方式，参考 include/items.inc.php 里的 get_item_by_hostid 方法，可以定义函数如下：

function get_items_by_groupid($groupid) {
        $items = array();
        $sql = 'SELECT DISTINCT key_ FROM items WHERE hostid IN (' .
                       'SELECT hostid FROM hosts_groups WHERE groupid=' . zbx_dbstr($groupid) .
                       ')';
        $db_items = DBselect($sql);
        while ($item = DBfetch($db_items)) {
                array_push($items, $item['key_']);
        }
        return $items;
}

这就可用了。

不过这个函数你只能在 require 了 items.inc.php 的 PHP 页面里使用，不能暴露成 RPC 接口。

修改为 RPC 接口

首先要简介一下 zabbix 的 RPC 接口是怎么传递的：

api_jsonrpc.php
|-> api/rpc/class.cjsonrpc.php
    |-> api/rpc/class.czbxrpc.php
        |-> include/classes/api/API.php

在 API.php 中，通过 getObjectClassName 方法，在本文件里的 $classMap 获取对象的类名。

所以，添加一个接口，分为几步：

1. 实现新的类；
2. 在 API.php 的 $classMap 里添加对应键值对；
3. 在 API.php 中添加返回对应类的方法(这步是为了能在其他代码里用 API::Item() 这样的调用方式)。

好，第一步，创建 api/classes/CItemByGroup.php 文件，内容如下：

<?php
class CItemByGroup extends CZBXAPI {
        public function get($groupid) {
                $items = array();
                $sql = 'SELECT DISTINCT key_ FROM items WHERE hostid IN (' .
                               'SELECT hostid FROM hosts_groups WHERE groupid=' . zbx_dbstr($groupid) .
                               ')';
                $db_items = DBselect($sql);
                while ($item = DBfetch($db_items)) {
                        array_push($items, $item['key_']);
                }
                return $items;
        }
}

第二步，添加 $classMap 键值对，内容如下：

    'itembygroup' => 'CItemByGroup',

第三步，添加对应方法，内容如下：

        /**
         * @return CItemByGroup
         */
        public static function ItemByGroup() {
                return self::getObject('itembygroup');
        }

这样，之前页面中直接使用 get_items_by_groupid($groupid) 的代码，就可以改写成：

$items = API::ItemByGroup()->get($groupid);

而在其他程序里，则可以用过 itembygroup.get 这个 RPC 接口获取相同结果了。

Zabbix Web 的布局和各种 helper 函数

zatree 项目中完全自己写了整个页面，所以像授权啊、返回其他页啊都比较麻烦。所以我们尽量了解一下 zabbix web 本身是怎么写的页面，把数据融合到整体风格里面去。

其实 zabbix web 页面布局非常简单。主要分为三部分：

1. include/page_header.php
2. new CWidget
3. include/page_footer.php

header 和 footer 是很顾名思义的。不过 page_header.php 里，通过 include/menu.inc.php 的 zbx_construct_menu() 方法，会校验访问者的权限。

新增页面授权

menu.inc.php 也很简单，跟前面 api 类似，也是一个大变量来控制菜单和页面的权限，这个变量叫 $ZBX_MENU。$ZBX_MENU 数组存放的，就是 zabbix web 顶部菜单大家看到的那几个标签，Monitoring、Report 等等。如果打算把页面加在顶部菜单上，那么就直接添加一个元素到 $ZBX_MENU 数组，如下：

        'sort' => array(
                'label'                 => _('Sort'),
                'user_type'             => USER_TYPE_ZABBIX_USER,
                'default_page_id'       => 0,
                'force_disable_all_nodes'=> true,
                'pages' => array(
                        array(
                                'url' => 'sort.php','label' => _('Sort')
                        )
                )
         ),

如果打算加到到次级菜单，比如放到 Monitoring 下面，那么找到 view 元素(其 label 为 “Monitoring”)，在其 pages 数组里加上即可：

                'pages' => array(
			...
                        array(
                                'url' => 'sort.php',
                                'label' => _('Sort'),
                        )
                )
        ),

CWidget 及其他组件

zabbix 虽然没有使用特别明确的 MVC 框架，倒也不用大家到处自己去拼接输出 HTML 代码，它已经实现了很多 helper 函数。

比如：

• group 和 item 的选择器，可以用 CComboBox() 生成；
• 页面交互的表单，可以用 CForm() 生成；
• 数据展示的表格，可以用 CTableInfo() 生成；
• history graph 的链接，可以用 CLink() 生成；

然后，CTableInfo() 可以 ->addRow()；CForm()、 CComboBox() 和 CWidget() 都可以 ->addItem()。

把各种元素都添加到 CWidget 里以后，调用 ->show() 方法即可。

此外，还提供有 check_fields, get_request, validate_sort_and_sortorder, getPageSortOrder, make_sorting_header 和 order_result 等方法帮助处理请求参数和数据表格展示。

最后效果如下：