1. 概述
1.1 版本
| 运维平台版本 | 功能变更 |
|---|---|
| V1.0 | - |
| V1.2 | 1）运维平台支持接入多个应用 2）运维平台支持接入非容器化部署的应用 3）运维平台支持接入设置了单点集成的应用 4）运维平台支持接入设置了反向代理的应用 |
1.2 功能简介
运维平台作为一个运维工具，是对帆软的FineReport、FineBI等应用进行运维的。
因此在使用运维平台之前，需要将需要被管理的应用绑定到运维平台上。
2. 使用前提
2.1 准备运维接口密钥
应用管理的前提是，运维平台获得应用的认可。因此首先要从应用中获取一个运维接口密钥。
管理员登录FineReport、FineBI等应用，点击「管理系统>智能运维>系统检查」。设置一个运维接口密钥，点击「保存」即可。
运维接口密钥请设置为大小写字母或数字，长度在8~14之间。
2.2 开启Nginx配置
Nginx状态监控模块ngx_http_stub_status_module是统计Nginx服务所接收和处理的请求数量的模块。
若需要被管理的应用，并非容器化部署的应用，则需要额外安装该模块。容器化部署的应用无需执行本操作。
2.2.1 安装模块
检查状态监控模块ngx_http_stub_status_module是否已安装。
nginx -V 2>&1 | grep -o with-http_stub_status_module
出现提示「with-http_stub_status_module」则表示已安装ngx_http_stub_status_module模块。
若未出现以上提示，则说明未安装ngx_http_stub_status_module模块，可执行以下命令安装此模块。
wget http://nginx.org/download/nginx-1.13.12.tar.gz
tar xfz nginx-1.13.12.tar.gz
cd nginx-1.13.12/
./configure --with-http_stub_status_module
make
make install
2.2.2 启用模块
启用ngx_http_stub_status_module模块查询Nginx状态。
location /nginx_status {
stub_status on;
allow 127.0.0.1; #only allow requests from localhost
deny all; #deny all other hosts
}
注意事项：
1）Location地址请严格命名为nginx_status。
2）allow 127.0.0.1和deny all表示仅允许本地访问。
若需允许Nginx Exporter访问，则可将这两行代码注释，或者将127.0.0.1设置为Nginx Exporter的IP地址。
2.2.3 重启Nginx
重启Nginx
nginx -t
nginx -s reload
验证ngx_http_stub_status_module模块是否已成功启动
curl http://127.0.0.1/nginx_status
出现提示「server accepts handled requests」则表示ngx_http_stub_status_module模块已成功启动。
2.3 确保网络连通
请确保运维平台和需要被管理的应用，可以互相访问，若网络不互通，则无法对接。
3. 新增应用
3.1 应用信息设置
管理员登录运维平台，点击「应用管理」，点击「新增应用」按钮，设置相关信息，点击「测试连接并保存」，如下图所示：
需要设置的应用信息如下表所示：
| 信息 | 说明 |
|---|---|
| 应用名称 | 自定义应用的名称 应用名称不允许为空 应用名称仅支持小写字母、数字 应用名称长度最大为12位 |
| 应用服务器地址 | FineReport、FineBI等应用的地址 应用服务器地址形如http://IP:port/webroot/decision 应用服务器地址不允许为空 |
| 运维接口密钥 | 2.1节设置的运维接口密钥 运维接口密钥不允许为空 |
连接成功后提示「连接成功」，点击确定，进入下一步。
3.2 组件信息设置
进入组件信息设置后，自动获取相关组件信息，点击「测试连接并保存」，如下图所示：
获取的组件信息如下表所示：
| 组件 | 信息 | 说明 |
|---|---|---|
| 外接数据库组件 | MySql组件名称 | 默认名称为：应用名称_mysql 禁止修改 |
| exporter地址 | IP地址 | |
| exporter端口 | 端口号 | |
| Redis组件 | 组件名称 | 默认名称为：应用名称_redis 禁止修改 |
| exporter地址 | IP地址 | |
| exporter端口 | 端口号 | |
| Nginx组件 | 组件名称 | 默认名称为：应用名称_nginx 禁止修改 |
| exporter地址 | IP地址 | |
| exporter端口 | 端口号 |
3.3 服务器信息设置
进入服务器信息设置后，自动获取相关组件信息，点击「测试连接并保存」，如下图所示：
获取的组件信息包括服务器的exporter地址和端口、promtail地址和端口。
连接成功后提示「保存成功」，点击确定，应用新增完毕。
4. 应用管理
应用管理界面，显示所有已绑定的应用，显示应用的相关信息，包括：应用名称、应用类型、存活节点数、部署方式、状态、应用地址
支持管理员增加新应用、删除和编辑已有应用。如下图所示：
5. 宕机处理策略
7. 健康诊断
在应用管理界面，可点击「健康诊断」按钮，快速直达「健康诊断」界面，如下图所示：
