Lepus（天兔）监控数据库

た入场券 2023-07-10 12:47 39阅读 0赞

该博文是参考[Lepus官方文档][Lepus]撰写的，官方文档蛮详细的，但是有些下载链接失效（这个开源产品的维护者比较忙，所以更新不太及时），也为了以自己的写作风格记录下lepus的使用方法，所以这篇博文就出现了。

> Lepus系统特性如下：
> 
>  *  无需Agent,远程监视云中数据库
>  *  WEB直观的管理和监视数据库
>  *  实时MySQL健康监视和告警
>  *  实时MySQL复制监视和告警
>  *  实时MySQL资源监视和分析
>  *  实时MySQL缓存等性能监视
>  *  实时InnoDB IO性能监控
>  *  MySQL表空间增长趋势分析
>  *  可视化MySQL慢查询在线分析
>  *  MySQL慢查询自动推送功能
>  *  MySQL AWR在线性能分析
>  *  实时Oracle健康监控和报警
>  *  实时Oracle表空间使用监控
>  *  实时Oracle性能监控
>  *  实时MongoDB健康监控和报警
>  *  实时MongoDB索引性能监控
>  *  实时MongoDB内存使用监控
>  *  实时Redis健康监控和报警
>  *  实时Redis性能监控
>  *  实时SQLServer健康监控和报警
>  *  实时OS主机CPU/内存/磁盘/网络/IO监控
>  *  可视化告警系统，邮件发送告警，短信接口支持
>  *  严格的权限认证系统
>  *  丰富的健康性能分析图表
>  *  多维的对比和性能分析

## 一、环境准备 ##

<table> 
 <thead> 
  <tr> 
   <th>OS</th> 
   <th>IP</th> 
   <th>主机名</th> 
   <th>角色</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Cent os 7.5</td> 
   <td>192.168.20.2</td> 
   <td>mysql</td> 
   <td>被监控端</td> 
  </tr> 
  <tr> 
   <td>Cent os 7.5</td> 
   <td>192.168.20.3</td> 
   <td>redis</td> 
   <td>被监控端</td> 
  </tr> 
  <tr> 
   <td>Cent os 7.5</td> 
   <td>192.168.20.4</td> 
   <td>lepus</td> 
   <td>监控端</td> 
  </tr> 
 </tbody> 
</table>

> 部署Lepus需要的核心如下：
> 
>  *  MySQL5.1及以上（必须,用来存储监控系统采集的数据）。
>  *  Apache 2.2及以上 （必须,WEB服务器运行服务器）。
>  *  PHP 5.3以上 （必须,提供WEB界面支持,不支持PHP7）。
>  *  Python2 （必须,推荐2.6及以上版本,执行数据采集和报警任务,不支持Python3）。
>  *  Python连接和监控数据库的相关驱动模块包：
>     
>      *  MySQLdb for python （Python连接MySQl的接口，用于监控MySQL,此模块必须安装）。
>      *  cx\_oracle for python （Python连接Oracle的接口，非必须,如果需要监控oracle此模块必须安装）。
>      *  Pymongo for python （Python连接MongoDB的接口，非必须,如果需要监控MongoDB此模块必须安装）。
>      *  redis-py for python （Python连接Redis的接口，非必须,如果需要监控Redis此模块必须安装）。

注：由于lepus官方文档最后一次更新是在17年，所以官方提供的很多下载链接失效了，我这里下载了所涉及到的所有软件包，版本与官方所用版本完全一致，有需要的话，可以通过我的网盘链接[下载][Link 1]，提取码：vofv 。

注：PHP和Python都是跨平台的语言，所以理论上系统应该可以支持在不同的平台上运行。但是由于时间和精力以及资源有限，目前天兔系统只测试完善了Centos/RedHat系统的支持。官方目前提供的技术支持也是只针对于Centos/RedHat系统，其他系统暂不支持技术服务。

## 二、部署LAMP环境 ##

lepus需要lamp环境的支持，配置lamp环境的方式有很多中，官方采用的是集成环境包Xampp进行部署的，所以这里就以官方为准。

> Xampp相关链接：
> 
>  *  [Xampp下载地址][Xampp]
>  *  [Xampp帮助文档][Xampp 1]

官方推荐xampp版本：xampp-linux-x64-1.8.2-5-installer.run。

**注意：接下来的所有操作，没有特殊声明的话，都是在lepus主机上进行的。**

#执行安装脚本
    [root@lepus src]# chmod +x xampp-linux-x64-1.8.2-5-installer.run 
    [root@lepus src]# ./xampp-linux-x64-1.8.2-5-installer.run 
    #执行后，一路默认回车即可。

出现如下所示，表示安装成功(lampp默认安装在/opt目录下)：  
![2020-02-29\_145248][2020-02-29_145248]

### 1、开启远程访问xampp ###

部署成功后，就在监听80端口，但是默认只能在本地访问，如需开启远程访问，需进行以下操作：

#### 1）编辑httpd-xampp.conf文件： ####

[root@lepus ~]# vim /opt/lampp/etc/extra/httpd-xampp.conf
    #更改如下：
    <LocationMatch "^/(?i:(?:xampp|security|licenses|phpmyadmin|webalizer|server-status|server-info))">
    #        Require local      #注释掉该行
           ErrorDocument 403 /error/XAMPP_FORBIDDEN.html.var
    </LocationMatch>
    #设置命令环境变量
    [root@lepus bin]# vim /etc/profile  #在末尾添加以下内容
    export PATH=/opt/lampp/bin:${PATH}
    [root@lepus bin]# source /etc/profile
    #重启服务，使更改生效
    [root@lepus ~]# httpd -k stop
    [root@lepus ~]# httpd -k start

浏览器访问lepus服务器，即可看到如下页面，表示lampp运行成功：

![2020-02-29\_153808][2020-02-29_153808]

## 三、安装python基础模块 ##

自行准备python环境，一般Centos系统自带python环境，python环境要求在2.6以上，但不支持python3。

以下几个python链接数据库的驱动包，选择性的安装即可（要监控哪种类型的数据库，就安装哪个包）。

### 1、安装MySQLdb for python （必须安装） ###

MySQLdb为Python连接和操作MySQL的类库，如果您准备使用lepus系统监控MySQL数据库，那么该模块必须安装。

[root@lepus ~]# yum -y install python-devel
    [root@lepus ~]# unzip MySQL-python-1.2.5.zip
    [root@lepus bin]# which mysql_config   #查看mysql_config命令的绝对路径
    /opt/lampp/bin/mysql_config
    [root@lepus ~]# cd MySQL-python-1.2.5/
    [root@lepus MySQL-python-1.2.5]# vim site.cfg  #修改以下
    mysql_config = /opt/lampp/bin/mysql_config   #指定mysql_config命令的绝对路径
    #进行安装
    [root@lepus MySQL-python-1.2.5]# python setup.py build
    [root@lepus MySQL-python-1.2.5]# python setup.py install

### 2、安装redis相关驱动（如果需要监控Redis则必须安装） ###

[root@lepus ~]# tar zxf redis-py-2.10.3.tar.gz 
    [root@lepus ~]# cd redis-py-2.10.3/
    [root@lepus redis-py-2.10.3]# python setup.py install

如果需要监控其他数据库，参考[官方文档][Link 2]去安装，某些软件包，在我博文的开头网盘链接中也有提供。

## 四、安装Lepus采集器 ##

注：以下所有操作都是在Lepus主机上进行，涉及到数据库授权等一些操作，也是在Lepus上进行，不用想这台主机没有装MySQL，lampp软件包已经集成了MySQL。

### 1、下载软件包 ###

[root@lepus ~]# cd /usr/local
    [root@lepus local]# git clone https://github.com/ruzuojun/lepus.git

如果git clone命令报错如下：

正克隆到 'lepus'...
    fatal: unable to access 'https://github.com/ruzuojun/lepus.git/': SSL certificate problem: unable to get local issuer certificate

请执行下面的指令即可：

[root@monitor local]# git config --global http.sslVerify false

### 2、对可执行文件授权，并创建软链接 ###

[root@lepus lepus]# pwd
    /usr/local/lepus
    [root@lepus lepus]# chmod +x lepus*
    [root@lepus lepus]# ln -sf /usr/local/lepus/lepus /usr/local/bin/
    [root@lepus lepus]# ln -sf /usr/local/lepus/lepus_monitor /usr/local/bin/

### 3、在监控机创建数据库并授权 ###

[root@lepus lepus]# ln -sf /opt/lampp/lampp /usr/local/bin
    [root@lepus lepus]# lampp start           #启动lamp环境
    [root@lepus lepus]# mysql -uroot   #默认数据库无密码
    #创建相关库及用户
    mysql> create database lepus default character set utf8;
    mysql> grant select,insert,update,delete,create on lepus.* to 'lepus_user'@'localhost' identified by '123.com';
    mysql> flush privileges;

### 4、导入SQL目录中的初始化SQL文件（表结构和数据文件） ###

[root@lepus lepus]# pwd
    /usr/local/lepus
    [root@lepus lepus]# mysql -uroot lepus < sql/lepus_table.sql
    [root@lepus lepus]# mysql -uroot lepus < sql/lepus_data.sql

### 5、修改配置文件 ###

[root@lepus lepus]# pwd
    /usr/local/lepus
    [root@lepus lepus]# cat etc/config.ini   #修改配置文件如下
    ###监控机MySQL数据库连接地址###
    [monitor_server]
    host="127.0.0.1"
    port=3306
    user="lepus_user"
    passwd="123.com"
    dbname="lepus"
    #注：上面指定的数据库信息是lepus主机用来存储采集到的信息的，并不是被监控端

### 6、启动lepus ###

[root@lepus lepus]# lepus start

**如果报错如下：**

[root@lepus lepus]# lepus start
    /usr/local/bin/lepus: 行 16: 72095 段错误               (吐核)nohup python lepus.py &>logs/lepus.log
    lepus server start fail!

则执行以下指令即可：

[root@lepus lepus]# ln -s /opt/lampp/lib/* /usr/lib64/
    [root@lepus lepus]# lepus start    #再次启动即可成功
    lepus server start success!

### 7、测试各个数据库驱动是否正常运行（非必须） ###

[root@lepus lepus]# pwd
    /usr/local/lepus
    [root@lepus lepus]# python test_driver_mysql.py 
    MySQL python drivier is ok!
    [root@lepus lepus]# python test_driver_redis.py 
    Redis python drivier is ok!

### 五、安装web管理台 ###

[root@lepus lepus]# vim /opt/lampp/etc/httpd.conf    #修改主配置文件
    <Directory />
        AllowOverride none
        Require all granted   # 214行左右，将原本的denied修改为granted
    </Directory>
                 ........  #省略部分内容
    Include etc/extra/httpd-vhosts.conf   # 488行左右，开启虚拟主机
    [root@lepus lepus]# vim /opt/lampp/etc/extra/httpd-vhosts.conf   #修改虚拟主机配置文件如下
    <VirtualHost *:80>
        ServerAdmin demo.lepus.cc
        DocumentRoot "/usr/local/lepus/web"
        ServerName demo.lepus.cc
        ServerAlias demo.lepus.cc
        ErrorLog "logs/demo.lepus.cc-error_log"
        CustomLog "logs/demo.lepus.cc-access_log" common
    </VirtualHost>
    [root@lepus lepus]# httpd -k restart  #重启httpd服务，使更改生效
    #修改php连接监控服务器的数据库信息
    [root@lepus lepus]# vim /usr/local/lepus/web/application/config/database.php
    $db['default']['hostname'] = '127.0.0.1';
    $db['default']['port']     = '3306';
    $db['default']['username'] = 'lepus_user';
    $db['default']['password'] = '123.com';
    $db['default']['database'] = 'lepus';
    $db['default']['dbdriver'] = 'mysql';

## 六、web界面配置 ##

登录到web界面进行登录，默认管理员账号密码为：admin/Lepusadmin，登录后建议修改管理员密码并增加普通用户。

### 1、登录 ###

![2020-02-29\_173422][2020-02-29_173422]

### 2、设置全局配置（设置监控） ###

全局配置设置比较简单，依次点击如下即可设置，最后点击保存即可。

![2020-02-29\_175615][2020-02-29_175615]  
![2020-02-29\_175806][2020-02-29_175806]

### 3、设置告警 ###

进入配置中心-全局设置，在告警标签页面里面可以看到告警设置。

在这里，可以设置是否开启告警，是否发送邮件，是否发送短信等等功能。

**告警最大次数**和告警休眠时间两个参数用于防止告警泛滥而设置，其含义是当连续告警次数达到告警最大次数则会停止发送告警通知，等侯时间超过告警休眠时间后如果告警未解除，则会继续发送告警。

如下（短信告警这里就不设置了）：

![2020-02-29\_180141][2020-02-29_180141]

### 4、配置邮件报警 ###

只有当邮件服务器配置成功，才可以正常发送邮件报警。我这里使用qq邮箱为例，其他邮箱服务大同小异。

进入配置中心-全局设置，在邮件标签里面，我们可以看到如下的邮件服务器设置：  
![2020-02-29\_180731][2020-02-29_180731]  
注：生成授权码不是这篇博文要说的，如果不会，自行百度解决吧。

若要配置短信报警，请参考[官方文档][Link 3]，同时在全局配置中还需要开启短信报警。

### 5、添加MySQL数据库实例 ###

注：Lepus支持MySQL，Oracle，MongoDB，Redis，SQLServer等数据库的监控。

监控MySQL数据库，无需在被监控端安装任何agent，只需创建一个有相应权限的用户即可。

#### 1）在被监控端创建授权用户 ####

**这个用户是要监控哪台主机就在哪台主机上创建，我这里是192.168.20.2这台主机**

mysql> grant select,process,super on *.* to 'lepus_monitor'@'192.168.20.%' identified by '123.com';
    mysql> flush privileges;

#### 2）web界面添加MySQL监控数据库 ####

![2020-02-29\_182541][2020-02-29_182541]  
![2020-02-29\_182802][2020-02-29_182802]

保存后，即可看到新增的MySQL实例：

![2020-02-29\_183400][2020-02-29_183400]  
我们可以通过观察日志来观察主机是否添加成功。在没有任何主机的时候，log里面会输出check mysql: not found any servers信息：

[root@MyCloudServer lepus]# tail -f logs/lepus.log 
    2017-04-27 16:45:55 [INFO] check mysql controller started.
    2017-04-27 16:45:55 [WARNING] check mysql: not found any servers
    2017-04-27 16:45:55 [INFO] check mysql controller finished.

当添加主机后，我们可以看到上面的提示消失了,这种状态说明Lepus采集进程已经发现了我们添加的主机:

2017-04-27 16:47:55 [INFO] check mysql controller started.
    2017-04-27 16:48:05 [INFO] check mysql controller finished.
    2017-04-27 16:48:44 [INFO] alarm controller started.
    2017-04-27 16:48:44 [INFO] alarm controller finished.

最后我们可以在MySQL监控菜单里发现我们添加的主机被监控了。  
点击如下，可以看到相应的监控项详细信息：  
![2020-02-29\_191624][2020-02-29_191624]

### 6、添加Redis监控实例 ###

#### 1）修改redis相关配置 ####

[root@redis ~]# vim /etc/redis.conf   #修改配置文件如下
    bind 0.0.0.0     #监听所有地址
    requirepass 123.com    #设置密码
    [root@redis ~]# systemctl restart redis   #重启生效

#### 2）web界面配置如下： ####

![2020-02-29\_192940][2020-02-29_192940]  
添加redis主机  
![2020-02-29\_193141][2020-02-29_193141]

按常理来说，此时应该已经采集到数据的，但是我测试了一下，数据并没有采集到，搜索一番，得到以下解决办法：

[root@lepus lepus]# pwd
    /usr/local/lepus
    [root@lepus lepus]# python check_redis.py    #需要手动执行一下这个测试脚本
    2020-02-29 21:16:06 [INFO] check redis controller started.
    2020-02-29 21:16:07 [INFO] check redis controller finished.

最后数据采集成功：  
![2020-02-29\_194114][2020-02-29_194114]

## 七、测试邮件报警功能 ##

由于在配置时，都是把链接数的阈值调的比较低，所以只需要多几个客户端去登录MySQL和redis数据库，指定的邮件收件人就可以收到如下邮件了：

MySQL的报警信息如下：

![2020-02-29\_194718][2020-02-29_194718]

redis的报警信息如下：

![2020-02-29\_194927][2020-02-29_194927]

若要监控慢查询、复制延迟等数据，请移步博文：[https://blog.csdn.net/u010725670/article/details/51038630][https_blog.csdn.net_u010725670_article_details_51038630] 。

[Lepus]: http://www.dbarun.com/docs/lepus/guide/
[Link 1]: https://pan.baidu.com/s/160NVwOcOOMv9xnbCqujV-g
[Xampp]: https://www.apachefriends.org/download.html
[Xampp 1]: https://www.apachefriends.org/faq_linux.html
[2020-02-29_145248]: https://gitee.com/lvjianzhao/ray-xsj/raw/master/%E5%B0%8F%E4%B9%A6%E5%8C%A0/2020-02-29_145248.png
[2020-02-29_153808]: https://gitee.com/lvjianzhao/ray-xsj/raw/master/%E5%B0%8F%E4%B9%A6%E5%8C%A0/2020-02-29_153808.png
[Link 2]: http://www.dbarun.com/docs/lepus/install/python-module/#2-%E5%AE%89%E8%A3%85cx_oracle-for-python-%EF%BC%88%E5%A6%82%E6%9E%9C%E9%9C%80%E8%A6%81%E7%9B%91%E6%8E%A7oracle%E5%88%99%E5%BF%85%E9%A1%BB%E5%AE%89%E8%A3%85%EF%BC%89
[2020-02-29_173422]: https://gitee.com/lvjianzhao/ray-xsj/raw/master/%E5%B0%8F%E4%B9%A6%E5%8C%A0/2020-02-29_173422.png
[2020-02-29_175615]: https://gitee.com/lvjianzhao/ray-xsj/raw/master/%E5%B0%8F%E4%B9%A6%E5%8C%A0/2020-02-29_175615.png
[2020-02-29_175806]: https://gitee.com/lvjianzhao/ray-xsj/raw/master/%E5%B0%8F%E4%B9%A6%E5%8C%A0/2020-02-29_175806.png
[2020-02-29_180141]: https://gitee.com/lvjianzhao/ray-xsj/raw/master/%E5%B0%8F%E4%B9%A6%E5%8C%A0/2020-02-29_180141.png
[2020-02-29_180731]: https://gitee.com/lvjianzhao/ray-xsj/raw/master/%E5%B0%8F%E4%B9%A6%E5%8C%A0/2020-02-29_180731.png
[Link 3]: http://www.dbarun.com/docs/lepus/configure/api/
[2020-02-29_182541]: https://gitee.com/lvjianzhao/ray-xsj/raw/master/%E5%B0%8F%E4%B9%A6%E5%8C%A0/2020-02-29_182541.png
[2020-02-29_182802]: https://gitee.com/lvjianzhao/ray-xsj/raw/master/%E5%B0%8F%E4%B9%A6%E5%8C%A0/2020-02-29_182802.png
[2020-02-29_183400]: https://gitee.com/lvjianzhao/ray-xsj/raw/master/%E5%B0%8F%E4%B9%A6%E5%8C%A0/2020-02-29_183400.png
[2020-02-29_191624]: https://gitee.com/lvjianzhao/ray-xsj/raw/master/%E5%B0%8F%E4%B9%A6%E5%8C%A0/2020-02-29_191624.png
[2020-02-29_192940]: https://gitee.com/lvjianzhao/ray-xsj/raw/master/%E5%B0%8F%E4%B9%A6%E5%8C%A0/2020-02-29_192940.png
[2020-02-29_193141]: https://gitee.com/lvjianzhao/ray-xsj/raw/master/%E5%B0%8F%E4%B9%A6%E5%8C%A0/2020-02-29_193141.png
[2020-02-29_194114]: https://gitee.com/lvjianzhao/ray-xsj/raw/master/%E5%B0%8F%E4%B9%A6%E5%8C%A0/2020-02-29_194114.png
[2020-02-29_194718]: https://gitee.com/lvjianzhao/ray-xsj/raw/master/%E5%B0%8F%E4%B9%A6%E5%8C%A0/2020-02-29_194718.png
[2020-02-29_194927]: https://gitee.com/lvjianzhao/ray-xsj/raw/master/%E5%B0%8F%E4%B9%A6%E5%8C%A0/2020-02-29_194927.png
[https_blog.csdn.net_u010725670_article_details_51038630]: https://blog.csdn.net/u010725670/article/details/51038630