本文将会演示如何在Eclipse中导入Zabbix的源码,并且对Zabbix的zabbix_agentd、zabbix_server、zabbix_get和zabbix_sender进行大略调试。

一、环境描述

操作系统

php5622targz若何在Eclipse中搭建Zabbix源码的调试和开辟情况 Docker

版本:CentOS 6.6 x86_64

安装办法:Desktop

IP地址:10.24.16.28

YUM源-1:EPEL Release

YUM源-2:RPM Forge

YUM源-3:MySQL Community

MySQL

版本:mysql-5.6.26-linux-glibc2.5-x86_64.tar.gz

安装办法:TAR压缩包

nginx

版本:nginx-1.10.1.tar.gz

安装办法:编译源码安装

PHP

版本:php-5.6.22.tar.gz

安装办法:编译源码安装

Java

版本:jdk-8u51-linux-x64.gz

安装办法:TAR压缩包

Zabbix

版本:zabbix-2.4.8.tar.gz

安装办法:调试源码

调试环境

IDE:eclipse-cpp-neon-R-linux-gtk-x86_64

GCC:4.4.7 20120313

GDB:7.2-75.el6

二、准备Zabbix调试环境

1. 更新系统

在Shell中运行以下命令,安装yum源:

rpm -ivh http://repo.mysql.com//mysql57-community-release-el6-8.noarch.rpm

rpm -ivh http://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm

rpm -ivh http://apt.sw.be/redhat/el6/en/x86_64/rpmforge/RPMS/rpmforge-release-0.5.3-1.el6.rf.x86_64.rpm

在Shell中运行以下命令,更新系统软件:

yum update -y

2. 安装MySQL

按照《在CentOS上安装MySQL数据库》的步骤进行安装。

3. 安装nginx

按照《在CentOS上安装nginx做事器》的步骤进行安装。

4. 安装PHP

按照《在CentOS上安装PHP》的步骤进行安装。

5. 安装Java

按照《在CentOS上安装Java》的步骤进行安装。

6. 下载Zabbix源码包

在Shell中运行以下命令,下载Zabbix源码包:

cd /root/Downloads

wget http://tenet.dl.sourceforge.net/project/zabbix/ZABBIX%20Latest%20Stable/2.4.8/zabbix-2.4.8.tar.gz

7. 安装依赖包

在Shell中运行以下命令,安装调试时必须的依赖包:

wget http://dl.fedoraproject.org/pub/epel/6/x86_64/iksemel-1.4-2.el6.x86_64.rpm

wget http://dl.fedoraproject.org/pub/epel/6/x86_64/iksemel-devel-1.4-2.el6.x86_64.rpm

wget http://dl.fedoraproject.org/pub/epel/6/x86_64/fping-2.4b2-10.el6.x86_64.rpm

wget http://cdn.mysql.com//Downloads/Connector-ODBC/5.3/mysql-connector-odbc-5.3.6-1.el6.x86_64.rpm

yum localinstall -y iksemel-1.4-2.el6.x86_64.rpm iksemel-devel-1.4-2.el6.x86_64.rpm fping-2.4b2-10.el6.x86_64.rpm mysql-connector-odbc-5.3.6-1.el6.x86_64.rpm

yum install -y OpenIPMI OpenIPMI-devel libssh2 libssh2-devel libcurl libcurl-devel net-snmp net-snmp-devel libxml2 libxml2-devel openldap openldap-devel unixODBC unixODBC-devel

8. 创建用户账户

在Shell中运行以下命令,创建用户和组:

groupadd zabbix

useradd -g zabbix zabbix

9. 创建Zabbix数据库

在Shell中运行以下命令,登录MySQL命令行(密码为password):

mysql -uroot -p

在MySQL命令行中运行以下命令,创建Zabbix数据库:

create database zabbix character set utf8 collate utf8_bin;

grant all privileges on zabbix. to zabbix@localhost identified by 'zabbix';

GRANT ALL PRIVILEGES ON zabbix. TO 'zabbix'@'%' IDENTIFIED BY 'zabbix';

FLUSH PRIVILEGES;

quit

由于本文将会调试Zabbix Server,因此须要在Shell中运行以下命令,建立做事端数据库的表构造(密码为password):

tar xvzf zabbix-2.4.8.tar.gz

cd zabbix-2.4.8/database/mysql/

mysql -uroot -p zabbix < schema.sql

mysql -uroot -p zabbix < images.sql

mysql -uroot -p zabbix < data.sql

10. 配置PHP

在Shell中运行以下命令,配置php.ini文件:

vi /usr/local/PHP/etc/php.ini

在上述文件中配置以下参数:

post_max_size = 16M

max_execution_time = 300

max_input_time = 300

date.timezone = Asia/Shanghai

always_populate_raw_post_data = -1

11. 配置unixODBC

在Shell中运行以下命令,创建软链接:

ln -s /usr/lib64/libmyodbc5w.so /usr/lib64/libmyodbc5.so

ln -s /usr/local/MySQL/lib/libmysqlclient.so.18 /usr/lib64/libmysqlclient.so.18

在Shell中运行以下命令,创建ODBC数据源配置文件:

vi /etc/odbc.ini

上述文件的内容如下所示:

[localhost]

Description = MySQL Localhost Database

Driver = MySQL

Server = 127.0.0.1

User = zabbix

Password = zabbix

Port = 3306

Database = zabbix

在Shell中运行以下命令,测试ODBC数据源配置:

isql -v localhost

若上述命令返复书息如下图所示,则表示ODBC数据源配置精确(若配置精确,则可以利用quit命令退出SQL命令行):

在SQL命令行中输入以下命令:

show tables;

若上述命令的输出信息如下图所示,则表明zabbix数据库建立成功,统共创建了104张表:

12. 安装Zabbix前端页面

在Shell中运行以下命令,安装前端页面:

mkdir -p /home/www/zabbix

cp -a /root/Downloads/zabbix-2.4.8/frontends/php/ /home/www/zabbix/

chown -R nginx.nginx /home/www/zabbix

三、下载和安装Eclipse CPP

1. 下载Eclipse CPP

在Shell中运行以下命令:

cd /root/Downloads

wget http://mirror.bit.edu.cn/eclipse/technology/epp/downloads/release/neon/R/eclipse-cpp-neon-R-linux-gtk-x86_64.tar.gz

2. 安装Eclipse CPP

在Shell中运行以下命令,将Eclipse安装至/usr/local目录:

tar xvzf eclipse-cpp-neon-R-linux-gtk-x86_64.tar.gz

mv eclipse /usr/local/Eclipse4C

3. 创建桌面快捷办法

在Shell中运行以下命令,在桌面上创建Eclipse的快捷办法:

vi /root/Desktop/Eclipse4C.desktop

这个文件的内容如下所示:

#!/usr/bin/env xdg-open

[Desktop Entry]

Version=1.0

Type=Application

Terminal=false

Icon[en_US]=/usr/local/Eclipse4C/icon.xpm

Name[en_US]=Eclipse4C

Exec=/usr/local/Eclipse4C/eclipse

Comment[en_US]=Eclipse CPP

Name=Eclipse4C

Comment=Eclipse CPP

Icon=/usr/local/Eclipse4C/icon.xpm

保存上述文件之后,修正它的实行权限:

chmod 755 /root/Desktop/Eclipse4C.desktop

现在,可以在桌面上看到Eclipse的快捷办法图标,如下图所示:

4. 配置事情空间

在桌面上双击运行Eclipse的快捷办法图标,将事情空间配置为/root/workspace目录,如下图所示:

四、导入和配置Zabbix源码

1. 将源码导入Eclipse

在Shell中运行以下命令,将zabbix的源码移动至事情空间中:

mv /root/Downloads/zabbix-2.4.8 /root/workspace/

然后,访问Eclipse的File → Import菜单,打开“导入工程”窗口,选择C/C++ → Existing code as Autotools project,如下图所示:

点击上图中的Next按钮,进入“导入已有代码”窗口,点击Browse按钮,找到zabbix-2.4.8源码目录的路径,然后再选择C project language选项,如下图所示:

点击上图中的Next按钮,进入编译和调试配置窗口,勾选“Build (GNU)”和“Debug (GNU)”,如下图所示:

末了,点击上图中的Finish按钮,Zabbix源码导入成功。
在Eclipse的Project Explorer视图中,可以看到Zabbix源码的工程,如下图所示:

2. 配置编译参数

在Eclipse的Project Explorer视图中,右键单击zabbix-2.4.8工程,然后在右键右键菜单中选择Properties,打开工程属性窗口,如下图所示:

在工程属性窗口中访问Autotools → Configure Settings,如下图所示:

在上图中访问configure → Directory specifiers,将安装的目录前缀指定为/usr/local/Zabbix,如下图所示:

在上图中访问configure → Advanced,勾选调试选项,并且指定其他的编译选项,如下图所示:

编译选项配置完成之后,终极状态如下图所示:

在上图中的All Options文本框中的编译选项如下所示(每个编译选项的详细含义,请参考《Zabbix 2.4.8源码配置选项解析》):

--prefix=/usr/local/Zabbix CFLAGS=\"大众-g\"大众 CXXFLAGS=\"大众-g\公众 --enable-server --enable-agent --enable-java --enable-ipv6 --with-mysql --with-jabber --with-libxml2 --with-unixodbc --with-net-snmp --with-ssh2 --with-openipmi --with-ldap --with-libcurl --with-iconv --with-iconv-include --with-iconv-lib

点击上图中的OK按钮,然后回到Eclipse的Project Explorer视图,右键单击zabbix-2.4.8工程,在右键菜单中选择Reconfigure Project,若configure脚本在掌握台的输出如下图所示,则表示配置成功:

3. 编译源码

在Eclipse的Project Explorer视图中,右键单击zabbix-2.4.8工程,在右键菜单中选择Build Project,编译Zabbix源码。
编译完成之后,就可以在zabbix-2.4.8工程的Binaries目录中看到编译得到的二进制文件,如下图所示:

4. 配置文件

在Shell中运行以下命令,拷贝配置文件:

mkdir -p /usr/local/Zabbix/etc/

cp -a /root/workspace/zabbix-2.4.8/conf/zabbix_agentd.conf /usr/local/Zabbix/etc/

cp -a /root/workspace/zabbix-2.4.8/conf/zabbix_server.conf /usr/local/Zabbix/etc/

在Shell中运行以下命令,配置Zabbix Server:

vi /usr/local/Zabbix/etc/zabbix_server.conf

在上述文件中配置以下参数:

DBHost=localhost

DBName=zabbix

DBUser=zabbix

DBPassword=zabbix

DBSocket=/usr/local/MySQL/sock/mysql.sock

5. 启动Zabbix Server/Agent后台做事

在Eclipse的菜单栏中访问Run → Run Configurations...,打开运行配置窗口,如下图所示:

双击上图左边栏中的C/C++ Application,然后新建一个名为zabbix_server的运行配置项,它的各项配置如下图所示:

Main配置:

Arguments配置:

还须要新建一个名为zabbix_agentd的运行配置项,它的各项配置如下图所示:

Main配置:

Arguments配置:

配置完成之后,点击窗口中的Run按钮,便可以运行Zabbix Server/Agent的后台做事了。
在Shell中运行以下命令:

pstree zabbix -ap

若上述命令的输出信息如下图所示,则表示Zabbix Server/Agent的后台做事成功运行:

6. 配置Zabbix前端页面

在浏览器中访问Zabbix的前端页面,URL如下所示:

http://10.24.16.28/zabbix/setup.php

进入Zabbix前端安装页面的首页,如下图所示:

点击“Next”按钮,进入必要条件检讨页面,如下图所示:

若各项配置检讨无误,则点击“Next”按钮,进入数据库连接配置页面,如下图所示:

数据库连接配置完成之后,必须首先点击“Test Connection”按钮,确保配置无误之后,才能点击“Next”按钮,进入Zabbix做事端详情页面,如下图所示:

填写好做事端主机的IP、端口号和主机名之后,点击“Next”按钮,进入安装前预览页面,如下图所示:

确认安装配置信息无误之后,点击“Next”按钮,进入安装结束页面,如下图所示:

点击“Finish”按钮,Zabbix前端页面便安装完成了。
此时,会自动跳转到Zabbix的登录页面,如下图所示:

默认的用户名和密码分别是Admin和zabbix,进入Zabbix监控的首屏,如下图所示:

进入首屏之后,点击首屏菜单中的“Configuration → Hosts”,进入主机配置页面,如下图所示:

由上图可知,作为Zabbix做事真个这台主机监控状态为“Disabled”,也便是没有对自己进行监控。
此时,可以点击赤色的“Disabled”,使监控状态变为绿色的“Enabled”,过几分钟刷新页面之后,便会创造Availability栏中的Z图标也会变绿,这就表明这台做事器目前是可用状态,如下图所示:

至此,Zabbix的前端页面已经安装和配置完成了。

五、调试Zabbix源码

1. 停滞运行Zabbix后台做事

在Shell中运行以下命令,停滞运行上文中运行的Zabbix后台做事:

killall zabbix_agentd

killall zabbix_server

几分钟之后,运行以下命令,确认Zabbix后台做事已经停滞:

ps aux | grep zabbix

2. 安装debuginfo

在CentOS(或其他Linux发行版)中,常日安装的软件(可实行文件和库文件)是不带有调试信息的。
因此,在利用GDB调试时,会涌现以下警告信息:

上述警告表示缺少相应软件包的调试信息,须要在Shell中运行以下命令,安装相应的debuginfo:

debuginfo-install OpenIPMI-libs cyrus-sasl-lib glibc gnutls iksemel keyutils krb5-libs libcom_err libcurl libgcc libgcrypt libgpg-error libselinux libssh2 libstdc++ libtasn1 libxml2-2.7.6 net-snmp-libs nspr nss nss-softokn-freebl nss-util openldap openssl unixODBC zlib

yum install ncurses-debuginfo gdbm-debuginfo

在本文利用的三个YUM源中都找不到libidn和libtool的调试信息,因此须要通过编译源码和更换文件的办法添加这两个软件相应的调试信息,运行如下命令:

# 编译和添加libidn的debuginfo

cd /root/Downloads

wget http://ftp.gnu.org/gnu/libidn/libidn-1.18.tar.gz

tar xvzf libidn-1.18.tar.gz

cd libidn-1.18

./configure

make

mv /lib64/libidn.so.11.6.1 /lib64/libidn.so.11.6.1.bak

cp ./lib/.libs/libidn.so.11.6.1 /lib64/

# 编译和添加libtool的debuginfo

cd /root/Downloads

wget http://mirror.hust.edu.cn/gnu/libtool/libtool-2.2.6b.tar.gz

tar xvzf libtool-2.2.6b.tar.gz

cd libtool-2.2.6b

./configure

make

mv /usr/lib64/libltdl.so.7.2.1 /usr/lib64/libltdl.so.7.2.1.bak

cp ./libltdl/.libs/libltdl.so.7.2.1 /usr/lib64/

在Shell中运行以下命令,查看上述两个库文件是否包含调试信息:

file /lib64/libidn.so.11.6.1

file /usr/lib64/libltdl.so.7.2.1

若上述两条命令的输出如下图所示,则表明编译和更换的库文件包含调试信息(not stripped):

至此,所有干系软件的debuginfo全部安装完成。
关于调试信息,请参考《详解Linux平台的调试信息文件》。

3. 创建GDB初始化脚本

在Shell中运行以下命令,创建GDB的初始化脚本文件:

vi /root/workspace/zabbix-2.4.8/.gdbinit

上述文件的内容如下所示:

set schedule-multiple on

set detach-on-fork off

set print thread-events on

handle SIGPIPE nostop

上面的配置表示:

set schedule-multiple on:表示所有进程的所有线程都许可运行。
这个选项是必须设置的。

set detach-on-fork off:表示可以同时调试父进程和子进程。

set print thread-events on:表示当GDB创造新的线程启动或退出时,输出调试信息至掌握台。

handle SIGPIPE nostop:表示当发生SIGPIPE旗子暗记时,当提高程不会停滞运行。

这个.gdbinit文件将会在Eclipse的调试器配置中利用。

4. 调试zabbix_server

在Eclipse的菜单栏上访问Run → Debug Configurations,打开调试配置窗口,这时可以创造已经存在一个名为zabbix_server的调试配置项,这是由于Eclipse会将先前新建的运行配置项的信息导入调试配置项之中。
可以创造调试配置窗口中的MainArguments标签页中的配置信息与运行配置项完备相同,并且还多出一个名为Debugger的标签页,这个标签页可用于配置GDB,如下图所示:

上图中的配置表示:

main函数的首行不要停息实行;

利用gdb命令作为调试器;

利用/root/workspace/zabbix-2.4.8/.gdbinit文件作为GDB的启动命令文件;

启用多进程GDB,自动调试创建的子进程。

点击上图中的Debug按钮,然后在Eclipse的Debug视图中规复所有停息进程的运行,zabbix_server的所有运行进程如下图所示(共有28个进程):

现在,只须要在待调试的代码行上打上断点,即可进行断点调试,例如在server.c源码中进行调试:

5. 调试zabbix_agentd

在Eclipse的菜单栏上访问Run → Debug Configurations,打开调试配置窗口,这时可以创造已经存在一个名为zabbix_agentd的调试配置项,而且调试配置窗口中的MainArguments标签页中的配置信息与运行配置项完备相同,并且还多出一个名为Debugger的标签页,这个标签页可用于配置GDB,如下图所示:

上图中的配置表示:

main函数的首行不要停息实行;

利用gdb命令作为调试器;

利用/root/workspace/zabbix-2.4.8/.gdbinit文件作为GDB的启动命令文件;

启用多进程GDB,自动调试创建的子进程。

点击上图中的Debug按钮,然后在Eclipse的Debug视图中规复所有停息进程的运行,zabbix_agentd的所有运行进程如下图所示(共有8个进程):

现在,只须要在待调试的代码行上打上断点,即可进行断点调试,例如在zabbix_agentd.c源码中进行调试:

6. 调试zabbix_get

zabbix_get是一个命令行工具,可用于从一个远程的Zabbix探针获取监控数据,其用法可以参考《zabbix_get和zabbix_sender工具的利用方法》。

首先,按照上文描述的方法,运行Zabbix Agent的后台做事。
然后,在Eclipse的菜单栏上访问Run → Debug Configurations,打开调试配置窗口,新建一个名为zabbix_get的调试配置项:

Main标签页中的配置信息如下图所示:

Arguments标签页中的配置信息如下图所示:

根据上图的输入参数可知,以127.0.0.1(本机)作为受监控主机,10050作为被动监听的端口,system.cpu.load[all,avg1]作为获取数据的监控项。

Debugger标签页中的配置信息如下图所示:

各个配置信息和zabbix_server、zabbix_agentd相同。

zabbix_get.c源码中打好断点,然后开始调试,如下图所示:

运行结束之后,可以在Eclipse的掌握台上看到这次调试指定监控项的监控数据,如下图所示:

7. 调试zabbix_sender

zabbix_sender是一个命令行工具,可用于向一个远程的Zabbix做事器发送监控数据,其用法可以参考《zabbix_get和zabbix_sender工具的利用方法》(http://toutiao.com/i6305830442683597313/)。

首先,按照上文描述的方法,运行Zabbix Server/Agent的后台做事。
然后,在上文配置的Zabbix前端页面中,为本机添加一个名为Test Query的监控项,每项配置如下图所示:

由上图可知:

监控项的名称:Test Query

监控项的类型:Zabbix trapper

监控项的关键字:test.queries

监控项的返回类型:Numeric (float)

这个监控项的别的配置保持默认即可。
然后,在Eclipse的菜单栏上访问Run → Debug Configurations,打开调试配置窗口,新建一个名为zabbix_sender的调试配置项:

Main标签页中的配置信息如下图所示:

Arguments标签页中的配置信息如下图所示:

根据上图的输入参数可知,利用/usr/local/Zabbix/etc/zabbix_agentd.conf作为Zabbix Agent的配置文件,利用Zabbix server作为Zabbix Agent的主机名(在Zabbix前端页面上为本机配置的主机名和此处的主机名相同),利用test.queries作为待发送的监控项,利用342.45作为待发送的监控数据。

Debugger标签页中的配置信息如下图所示:

各个配置信息和zabbix_server、zabbix_agentd相同。

zabbix_sender.c源码中打好断点,然后开始调试,如下图所示:

运行结束之后,可以在Eclipse的掌握台中看到zabbix_sender的输出结果,如下图所示:

除此之外,还可以在Zabbix的前端页面上看到这次调试指定监控项的监控数据,如下图所示:

至此,基于Eclipse的Zabbix源代码的调试和二次开拓的环境已经全部搭建完成了,往后还会逐步剖析Zabbix各个组件源码的事情事理,敬请期待!