月份：2017年12月

通过上一章《Docker下实战zabbix三部曲之二：监控其他机器》的实战，我们了解了对机器的监控是通过在机器上安装zabbix agent来完成的，zabbix agent连接上zabbix server之后，将自己所在机器的信息定时给到zabbix server，这样就实现了机器的监控；
但是我们能监控到的只有cpu，磁盘这些基础信息，对于一些业务信息例如访问量，某个逻辑的执行成功失败次数等信息，我们也想进行监控，这就需要我们去制作自定义监控项了，本章我们就一起来实战自定义监控项吧。

机器部署情况一览

总的来说，有四台机器，各自的功能如下：
a. 假设有一个机器在运行web应用，容器是tomcat，这个应用有个接口http://localhost:8080/zabbixcustomitemdemo/count，可以返回最近一分钟的某个业务量(例如网站访问次数)；

b. 有一台机器安装了zabbix agent，作为自定义监控项的载体；
c. 有一台机器安装了zabbix server；
d. 有一台机器安装了mysql，作为zabbix系统的数据库；

整体部署如下图所示：

运行web应用的server

这是个基于maven的java web应用，里面有个spring mvc的controller，提供一个http服务，范围某个业务每分钟的业务量，代码如下图所示：

@Controller
public class CountController {

    @RequestMapping("/count")
    @ResponseBody
    public int count(String model, String type) {
        int base;
        int max;
        int min;

        if("a".equals(model)){
            base = 50000;
        }else{
            base =10000;
        }

        if("0".equals(type)){
            max = 9000;
            min = 1000;
        }else{
            max = 1000;
            min = 0;
        }

        return base + new Random().nextInt(max)%(max-min+1);
    }
}

从以上代码我们可以看出，http服务会返回随机数，此服务接受两个参数model和type，当model等于”a”时返回的随机数从50000开始，model不等于”a”时返回的随机数从10000开始，当type等于”0”时，在base的基础上增加的值是1000到9000之间，当type不等于”0”时，在base的基础上增加的值是0到1000之间；

整个工程的代码已经上传到git上，地址是[email protected]:zq2599/blog_demos.git，这个目录下由多个工程，本次实战的工程是zabbixcustomitemdemo，如下图：

docker-compose.yml文件

上面我们已经把四台机器的功能和关系梳理清楚了，现在就来制定docker-compose.yml文件吧：

version: '2'
services:
  zabbix-mysql-service: 
    image: daocloud.io/library/mysql:8
    container_name: zabbix-mysql-service
    environment:
      - MYSQL_ROOT_PASSWORD=888888
    restart: always
  zabbix-server-service:
    image: monitoringartist/zabbix-xxl:3.2.6
    links: 
      - zabbix-mysql-service:mysqlhost
    container_name: zabbix-server-service
    restart: always
    depends_on:
      - zabbix-mysql-service
    ports:
      - "8888:80"
    environment:
      - ZS_DBHost=mysqlhost
      - ZS_DBUser=root
      - ZS_DBPassword=888888
  zabbix-agent-a:
    image: zabbix/zabbix-agent:ubuntu-3.2.6
    links: 
      - zabbix-server-service:zabbixserverhost
    container_name: zabbix-agent-a
    restart: always
    depends_on:
      - zabbix-server-service
    environment:
      - ZBX_HOSTNAME=zabbix-agent-service-a
      - ZBX_SERVER_HOST=zabbixserverhost
  tomcat-server-service:
    image: bolingcavalry/bolingcavalrytomcat:0.0.1
    container_name: tomcat-server
    restart: always
    ports:
      - "8080:8080"

yml文件的内容如上所示，其中mysql、zabbix server，zabbix agent的配置和上一章《Docker下实战zabbix三部曲之二：监控其他机器》是一样的，新增的是一个tomcat的镜像，这个镜像是我在tomcat官方镜像的基础上做了点小改动，使得这个tomcat支持在线部署web应用，关于tomcat在线部署应用，请看文章《实战docker，编写Dockerfile定制tomcat镜像，实现web应用在线部署》

准备好yml文件之后，打开终端，在yml文件所在目录下执行docker-compose up -d可以将yml文件中所有的容器都启动；

注意，如果您的电脑之前已经运行过上一章《Docker下实战zabbix三部曲之二：监控其他机器》中的docker-compose.yml文件，那么本次执行docker-compose up -d会提示启动失败，已有同样名称的容器存在，这时候可以去上一章的docker-compose.yml文件所在目录执行docker-compose down，也可以通过docker ps -a将所有容器列出，再通过docker stop命令依次停止所有容器，再执行docker-compose rm命令依次删除；

部署web应用

打开终端，进入web工程zabbixcustomitemdemo的目录下，执行命令mvn clean package -U -Dmaven.test.skip=true tomcat7:redeploy，即可将web工程部署到tomcat容器上，关于在线部署的细节请参照文章《实战docker，编写Dockerfile定制tomcat镜像，实现web应用在线部署》;

部署成功后，打开浏览器，访问http://localhost:8080/zabbixcustomitemdemo/count，web server会返回一个数字，如下图所示：

制作访问url的shell脚本

接下来我们要在zabbix agent上做一个shell脚本，此脚本的功能时发起http请求http://localhost:8080/zabbixcustomitemdemo/count?model=a&type=0，就能得到web服务响应的数字，如果此脚本每分钟被调用一次，就能得到完整的监控曲线图了；

a. 首先，执行docker exec -it zabbix-agent-a /bin/bash登录zabbix agent的容器；
b. 登录后，执行apt-get update更新apt；
c. 先后执行apt-get install wget和apt-get install vim，安装wget和vi工具；
d. 新建目录/usr/work/,在此目录下用vi创建一个shell文件biz_count.sh，内容如下：

#"!/bin/bash
wget -qO- http://tomcathost:8080/zabbixcustomitemdemo/count?model=$1&type=$2
echo ""

上面代码的功能是访问http服务获取一个数字，其中model和type用的是shell的入参；
注意两个细节：
第一个：最后一行代码echo “”，实践证明这一行是很有用的，有了这一行就会在输出http返回的数字后进行换行，有了换行数据才能成功上报到zabbix server；
第二个：wget命令后面的url参数中,”&”符号前面要加转义的斜杠””；

e. 执行chmod a+x biz_count.sh，给shell赋予可执行权限；

agent上添加监控项

继续在zabbix agent容器上，我们要添加一个自定义监控项，这样后面在zabbix server上就能使用该监控项了：
a. 在/etc/zabbix/zabbix_agentd.d目录下，新增一个biz.conf文件，内容如下：

UserParameter=get_total_num[*],/usr/work/biz_count.sh $1 $2

以上代码配置了一个自定义监控项，名称是get_total_num，可以接受两个入参，该监控项会调用biz_count.sh这个脚本，并且把外部传来的两个入参直接传递给biz_count.sh;

b. 执行chmod a+r biz.conf使得该文件可读；

在zabbix agent上测试

继续在zabbix agent容器上，执行以下命令来测试刚刚新加的监控项：

/usr/sbin/zabbix_agentd -t get_total_num[a,0]

中括号中的a,0表示两个入参分别是”a”和”0”，我们执行四次，入参分别用[a,0]、[b,0]、[a,1]、[b,1]，得到的结果如下图所示：

四个返回值分别是54741、17097、50564、10919，结合前面的java代码可以发现两个参数都生效了，数字的大小范围因入参而变化；

为了让监控项生效，需要重启zabbix agent，不过这里有个更快捷的方法可以试试：
a. 执行exit退出zabbix agent容器；
b. 执行docker restart zabbix-agent-a重启zambia agent容器；

到了这里，自定义监控项已经准备好了，接下来在zabbix server上把它配置成功，我们就能看到监控数据和曲线图了，不过在配置前，我们可以在zabbix server上测试一下能否成功调用zabbix agent上的监控项；

在zabbix server上测试agent机器的监控项

首先我们要搞清楚zabbix agent机器的ip，有两种方法：
第一种，执行docker exec -it zabbix-agent-a /bin/bash登录zabbix agent的容器，在容器中执行ip addr命令可以得到ip；
第二种，直接执行docker exec -it zabbix-agent-a ip addr命令得到ip；

不论哪种，都能得到zabbix-agent的ip是172.31.0.5;

现在我们登录zabbix server容器，执行命令docker exec -it zabbix-server-service /bin/bash即可登录,登录后执行以下命令：

zabbix_get -s 172.31.0.5 -k get_total_num[a,0]

如下图所示，测试成功，调用agent的监控项返回了符合预期的数据：

还记得我们刚才在zabbix agent上配置好之后，需要重启agent服务或者重启zabbix agent容器，如果您忘了这一步，现在zabbix server上测试会得到如下错误提示：

这时候去重启一下，再回来测试就可以成功了。

在管理页面上添加监控项

在浏览器上输入”http://localhost:8888/“登录管理页面，先添加agent机器，如下图：

添加之后，点击下图红框位置，进入监控项页面：

如下图，点击右上角的“Create item”即可开始添加监控项：

新增的监控项，我们只要填写Name，Key，Update interval（更新频率）这几个字段，其他的保持不变，每个要更新的字段的内容如下图：

填写并保存后，我们可以在Monitoring -> Latest data中看到最新的监控项数据，如下图：

接下来我们添加一个监控图形，操作如下图所示，可以进入图形管理页面：

如下图，点击右上角的“Create graph”创建一个图形：

新建图形的时候，名称随意，只要Items选中刚刚创建的监控项即可，如下图：

创建成功，现在要看看效果了，操作如下图所示：

点击”add”之后，在弹出的页面上选择刚刚我们新建的图形选项，操作完毕后，点击下图红框位置，就能看见曲线图了：

曲线图如下：

以上就是自定义监控项开发和设置的所有过程，基于监控项的操作，除了图形还能添加tirgger用来告警，在添加action用来确定告警的动作，例如邮件短信的，有兴趣的读者可以实际操作实战。

在上一章《Docker下实战zabbix三部曲之一：极速体验》中，我们快速安装了zabbix server，并登录管理页面查看了zabbix server所在机器的监控信息，但是在实际场景中，应该是对应用服务器做监控，所以今天我们来实战将应用服务器的监控加入到zabbix server中。

部署情况

假设实际项目中我们有两台应用服务器，为了监控它们，我们要在上面分别安装zabbix-agent服务，然后通过配置让它们与zabbix server连接，所有监控数据和监控配置数据都被zabbix server保存在mysql中，部署情况如下图：

真实场景中是在应用服务器上安装zabbix agent服务，但是安装agent的过程和步骤不是本次实践的重点，为了快速体验服务本文使用了zabbix官方的agent镜像，这个镜像实际上就是在ubuntu14上安装了zabbix agent（在服务器上安装zabbix agent的过程就不在本文中详述了，对安装有兴趣的读者们可以去网上搜索相关资料）

docker-compose.yml文件

按照前面图片所示的部署情况，我们的docker-compose.yml内容如下，mysql和zabbix server是必须的，再新增了两个zabbix agent容器，名称分别是zabbix-agent-a和zabbix-agent-b：

version: '2'
services:
  zabbix-mysql-service: 
    image: daocloud.io/library/mysql:8
    container_name: zabbix-mysql-service
    environment:
      - MYSQL_ROOT_PASSWORD=888888
    restart: always
  zabbix-server-service:
    image: monitoringartist/zabbix-xxl:3.2.6
    links: 
      - zabbix-mysql-service:mysqlhost
    container_name: zabbix-server-service
    restart: always
    depends_on:
      - zabbix-mysql-service
    ports:
      - "8888:80"
    environment:
      - ZS_DBHost=mysqlhost
      - ZS_DBUser=root
      - ZS_DBPassword=888888
  zabbix-agent-a:
    image: zabbix/zabbix-agent:ubuntu-3.2.6
    links: 
      - zabbix-server-service:zabbixserverhost
    container_name: zabbix-agent-a
    restart: always
    depends_on:
      - zabbix-server-service
    environment:
      - ZBX_HOSTNAME=zabbix-agent-service-a
      - ZBX_SERVER_HOST=zabbixserverhost
  zabbix-agent-b:
    image: zabbix/zabbix-agent:ubuntu-3.2.6
    links: 
      - zabbix-server-service:zabbixserverhost
    container_name: zabbix-agent-b
    restart: always
    depends_on:
      - zabbix-server-service
    environment:
      - ZBX_HOSTNAME=zabbix-agent-service-b
      - ZBX_SERVER_HOST=zabbixserverhost

如上所示，zabbix agent在配置过程中要用到zabbix server的ip信息，这里我们通过links参数，在zabbix agent的host文件中加入了zabbix server的ip信息，host name是zabbixserverhost；

另外，ZBX_HOSTNAME和ZBX_SERVER_HOST这两个环境变量，在zabbix agent镜像的官方文档中已经说明，如下图，ZBX_HOSTNAME用来表示自己的身份，ZBX_SERVER_HOST是用来标明zabbix server的ip信息的，这里直接用link参数中的alias来表示，就能通过host直接找到zabbix server的ip了：

启动docker 容器

打开控制台，在docker-compose.yml文件所在的目录下执行命令docker-compose up -d，如图：

进入控制台

等待大约1分钟，让zabbix server完成初始化，然后就能登录管理页面了，详情请参照《Docker下实战zabbix三部曲之一：极速体验》一文，登录后进入hosts页面，如下图：

获取监控机器ip

按照前面的部署描述图上的部署，有两台机器装了zabbix agent服务，然后想要加入监控，第一步我们要把机器的ip确定下来，在控制台执行docker exec -it zabbix-agent-a ip addr命令，可以看到如下输出，第一台机器的ip是172.31.0.4：

在控制台执行docker exec -it zabbix-agent-b ip addr命令，可以看到如第二台机器的ip是172.31.0.5；

添加机器监控

点击hosts页面右上角的Create host按钮，可以添加监控机器，如下图：

在添加机器的页面，主要参数填写如下：
a. Host name ：机器的环境变量ZBX_HOSTNAME的值：zabbix-agent-service-a；
b. Visible name ：和Host name的值相同；
c. Groups : 机器分组，这里选择Linux servers；
d. Agent interfaces：这里面只需要填写IP address，就是刚才我们通过命令docker exec -it zabbix-agent-a ip addr得到的ip：172.31.0.4；
这个页面只需要填写以上四点内容，其他的都保持默认值，填写完毕后点击底部的”Add”按钮，如下图：

增加成功后，在列表中可以看到新增的机器，如下图：

添加监控项

在机器列表页面中，点击机器名称，如下图红框中位置：

在打开的页面点击”Templates”，如下图红框所示：

再点击”Select”按钮，如下图红框所示：

在弹出的页面中，勾选“Template OS Linux”，然后再点击底部的“Select”按钮，这样就把linux服务的常用监控项给批量添加了，如下图：

注意，返回的页面中，一定要点击“Add”才能让把刚才的选择加上，如下图：

然后点击“Update”，完成监控项的批量添加，如下图：

按照同样的方法把另一台机器的监控也加上；

等待大约1-2分钟后，再刷新hosts页面，就能看到列表中的”ZBX”图标已经变为绿色，表示监控已经生效；

查看监控信息

我们来看看监控曲线图吧，点击下图红框中的“Graphs”：

可以看到有5个曲线图可以查看，如下图，我们看一下cpu load：

在跳转的页面中，点击“Previdew”，就能看到cpu load的曲线图了，如下图：

至此，我们添加监控机器的实战已经完成了，但是在真实场景中，我们除了cpu、磁盘等基础信息的监控，还要监控一些业务有关的数据，例如某个http服务每分钟的访问量，在下一章中，我们一起实战开发一个自定义监控。

对于想学习和实践zabbix的读者来说，在真实环境搭建一套zabbix系统是件费时费力的事情，本文内容就是用docker来缩减搭建时间，目标是让读者们尽快投入zabbix系统的体验和实践；

创建docker-compose.yml文件

首先创建一份docker-compose.yml文件，内容如下：

version: '2'
services:
  zabbix-mysql: 
    image: daocloud.io/library/mysql:8
    container_name: zabbix-mysql
    environment:
      - MYSQL_ROOT_PASSWORD=888888
    restart: always
  zabbix-server:
    image: monitoringartist/zabbix-xxl
    links: 
      - zabbix-mysql:mysqlhost
    container_name: zabbix-server
    restart: always
    depends_on:
      - zabbix-mysql
    ports:
      - "8888:80"
    environment:
      - ZS_DBHost=mysqlhost
      - ZS_DBUser=root
      - ZS_DBPassword=888888

创建容器

打开命令行，在刚才创建的docker-compose.yml目录下，执行docker-compose up -d，这样就会先后启动mysql和zabbix server两个服务的容器，如下图：

等待zabbix server初始化

在命令行输入命令docker logs -f zabbix-server-service，查看zabbix server的日志输出，下图是部分日志的截图，可以看到有数据库初始化的操作：

登录zabbix管理页面体验

等待大约一分钟之后，zabbix server的日志不再滚动，表示初始化已经完成，打开浏览器输入http://localhost:8888，可以看到zabbix的管理系统的登录页面，如下图：

输入用户名admin，密码zabbix

登录后即可看到管理系统了，如下图：

按照下图的操作，查看已经监控的主机情况，如图，目前只能看到一台机器的信息，就是zabbix server自己这台机器，从列表的几列信息中可以看到有64个监控项，43个触发器，10个图形：

上图右侧的红框中显示的status是”Disabled”，表示这个host的监控还没有启动，点击这个”Disabled”就能启动监控，将状态变为”Enabled”，大约1分钟后再刷新页面，可以看到展示如下图：

除了状态变为”Enabled”,右侧原本灰色的”ZBX”也变成了绿色，表示该机器的监控状态是正常的；

体验监控图形

按照下图的红框和箭头操作，可以看到zabbix server所在机器的cpu load的曲线图：

显示中文

按照下图的箭头依次点击红框中的内容：

在打开后的页面中按照下图的箭头依次选择和点击：

这时候再点击右上角的”注销”按钮，退出重现登录，如下图红框所示：

再重新登录后，就能看见页面已经全部中文显示了，如下图：

以上就是Docker下实战zabbix的第一部分，快速体验zabbix系统和服务，但只有一个zabbix server服务器意义不大，毕竟实际场景是要通过zabbix系统去监控其他机器和服务，下一章我们尝试把zabbix agent加入进来，以更接近实际场景的方式来继续学习zabbix。