# 字符云监控开源版
**Repository Path**: outoftime/open
## Basic Information
- **Project Name**: 字符云监控开源版
- **Description**: 集监控点监控、日志监控、数据可视化以及监控告警为一体的国产开源监控系统，直接部署即可使用。项目演示地址：
- **Primary Language**: C++
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: http://open.xrkmonitor.com
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 341
- **Created**: 2019-09-05
- **Last Updated**: 2020-12-19
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 字符云监控开源版
## 项目简介
集成监控点监控、日志监控、数据可视化以及监控告警为一体的国产开源监控系统，直接部署即可使用。
相比其它开源监控系统优势：
```
1. 安装部署配置简单，支持自动化配置
2. API接口清晰，易于使用
3. 告警设置方便
4. 集成日志功能
5. 告警通道无需开发，且支持多种告警方式
```
**项目演示链接：[字符云监控开源版演示 http://open.xrkmonitor.com](http://open.xrkmonitor.com)**
(演示账号在登录窗下方查看, 提供两类账号：管理员账号、普通账号做为演示账号)
**web 控制台首页展示:**
**日志查看界面:**
**监控点数据图表查看界面:**
**微信告警示例:**(支持邮件、短信、微信、PC客户端等告警方式，告警功能无需开发直接可用)
## 视频教程
视频教程紧急制作中，感谢大家关注
1. 源码介绍和编译(ubuntu系统) [源码介绍和编译 https://www.bilibili.com/video/av66685598](https://www.bilibili.com/video/av66685598)
## 编译说明
视频教程：[源码介绍和编译 https://www.bilibili.com/video/av66685598](https://www.bilibili.com/video/av66685598)
项目目前只支持在 linux 系统中编译，推荐使用 opensuse 或者 ubuntu 系统
项目依赖 mysql 开发库 libmysqlclient.so、protobuf、curl、fcgi，其中 protobuf、curl、fcgi 的源
码已经集成到项目中，您只需要安装 libmysqlclient.so 开发库即可，安装完成后执行如下操作即可编译：
1. 修改 make_env 文件，指定 libmysqlclient 库/头文件的安装路径
2. 执行脚本 ./install_dev.sh，按提示根据需要完成编译依赖包的安装
3. 执行 make 命令即可编译整个项目，后续如需编译指定模块在模块目录执行 make 命令即可
## 部署说明
字符云监控系统部署需要安装 memcached，mysql，apache 软件
部署前需要将 memcached 可执行文件放入 slog_memcached 目录下，并重命名为 slog_memcached
(memcached 可执行文件通过编译 memcache 源码或者从 rpm 发布包中获取)
控制台cgi 在部署时支持普通cgi以及 fastcgi 方式，如需使用 fastcgi 方式部署需要 apache 导入模块
mod_fastcgi , 模块源码在 lib 目录下，fastcgi 参考配置文件：cgi_fcgi/fastcgi.conf
部署方式支持集中部署、分布式部署，部署方法如下：
### 集中部署
全部服务部署在一台服务器上的操作步骤：
1. 在部署机上安装 mysql, apache 软件
2. 安装拷贝 memcached 可执行文件到路径 slog_memcached 目录下，并重命名为 slog_memcached
3. 打完整部署包：cd tools_sh; ./make_all.sh 生成： slog_all.tar.gz 部署包
4. 将部署包 slog_all.tar.gz 拷贝到部署机器的部署目录下
5. 解压部署包： tar -zxf slog_all.tar.gz; tar -xf slog_all.tar
6. 初始化 mysql 数据库，将 mtreport_db.sql, attr_db.mysql 导入到 mysql 中(文件在源码 db 目录下)
7. 授权 mysql 账号：mtreport 访问密码：mtreport875, 访问操作 mtreport_db,attr_db 数据库
8. 启动 slog_config 服务: cd slog_config; ./start.sh
9. 拷贝 html、cgi 文件到 apache 网站，网站根目录设为： /srv/www/htdocs，按如下方法拷贝文件：
a. 部署 html/js 文件：将源码中 html 目录下的文件/目录全部拷贝到 /srv/www/htdocs/monitor 目录下
b. 将入口文件 html/index.html 拷贝到根目录下 /srv/www/htdocs
c. 部署 cgi：将部署机 cgi_fcgi 目录下的文件全部拷贝到 /srv/www/cgi-bin 目录下
d. 创建 cgi 本地日志目录：/var/log/mtreport，cgi 调试目录：/srv/www/htdocs/cgi_debug
10. 启动 apache，使用内置账号：sadmin, 密码：sadmin 访问控制台，将系统服务器配置的IP 全部改为部署机IP
11. 启动所有服务：进入部署目录，cd tools_sh; ./check_proc_monitor.sh 1，约1分钟后即可查看日志和监控点图表
### 分布式部署说明
开源版监控系统包含以下服务器类型：
1. mysql 配置服务器，用于存储监控系统的相关配置(分布式部署时，需要在 slog_config.conf 中配置)
2. mysql 监控点服务器，用于存储监控点数据(可在控制台配置，系统自动调度)
3. web 控制台服务器，用于部署web 控制台
4. 监控点服务器，用于接收监控点数据上报(可在控制台配置，系统自动调度)
5. 日志服务器，用于接收日志，并提供日志查询功能(可在控制台配置，系统自动调度)
6. agent 接入服务器，用于控制 agent 接入以及下发配置到 agent(agent 模块为：slog_mtreport_client)
监控系统部署的基本包，包含如下模块(关于模块的说明在各模块源码文件的头部，这里不做说明)
1. slog_config
2. slog_client
3. slog_monitor_client
4. tools_sh 目录以及其下的全部脚本文件
监控系统各模块部署时需从模块源码目录中拷贝如下文件(以下使用 slog_config 模块作为示例说明)
1. 模块可执行文件 (slog_config)
2. 模块配置文件 (slog_config.conf)
3. 模块目录下的全部脚本文件 (start.sh,stop.sh等)
分布式部署推荐部署方式：
1. mysql 配置服务/web 控制台服务/agent 接入服务, 同机部署, 需要部署如下模块： (1台)
a: 部署基本包(基本包的内容如上文)
b: 部署 slog_mtreport_server 模块
c: 注意打包文件中需要包含 slog_memached 模块, web 控制台服务依赖该模块
2. mysql 监控点服务器/监控点服务器, 部署在一台机器上需要部署如下模块： (1台)
a: 部署基本包(基本包的内容如上文)
b: 部署 slog_monitor_server/slog_check_warn/slog_deal_warn 模块
3. 日志服务器 (1台或多台)
a: 部署基本包(基本包的内容如上文)
b: 部署 slog_server/slog_write 模块
c: 部署 apache 服务，部署 cgi 模块：mt_slog，提供日志查询服务
4. 被监控机器 (目前只支持 linux 系统，1台或多台)
a: 只需部署监控系统 agent 模块：slog_mtreport_client
## 联系我们
QQ 群 699014295 (加群密码：xrkmonitor):
微信公众号:
邮箱：1820140912@qq.com