接入外部数据源的数据

适配范围

外部数据源：当前仅支持接入MySQL数据库数据。
Collector：4.2.0.0及以上，并启用Guanyun Collector模块。

接入MySQL数据库的数据

接入流程概述

确认接入目标：梳理需接入的MySQL环境信息，包括MySQL实例IP、数据库名称、数据表名称。
确定数据采集位置：在与目标MySQL主机处于同一网络环境的机器上部署Collector，并确认用于拉取数据的Collector IP。
申请数据库访问权限：联系运维团队，在目标MySQL主机上创建只读监控账号，要求：
- 权限范围仅限于目标数据库及表
- 仅授予SELECT权限
- 仅允许来自上述Collector IP的访问
开通网络访问：联系运维放开Collector→MySQL的防火墙访问策略（Collector IP→MySQL IP:端口）。
部署或复用Collector：确认当前环境是否已有可用Collector，按需复用或安装部署。
配置数据源：在观云平台数据集成轻应用中，配置MySQL数据源连接。
生成数据库指标：在观云平台指标体系轻应用中，基于接入的数据源配置并生成相应的数据库指标。

具体配置步骤

步骤一：确认接入目标

在接入前，请确认以下信息（用于数据库账号授权与平台配置）：

MySQL实例 IP
数据库名称
数据表名称
Collector 部署 IP（需与 MySQL 同一网络环境）

步骤二：准备或安装 Collector

通过Collector拉取MySQL数据，需要保证Collector与MySQL网络互通。

方式一：复用现有Collector（推荐）

如果当前网络环境中已有Collector，可直接复用，无需重新安装。

确认并启用Guanyun Collector模块：

检查模块状态：

grep 'guanyun_enabled' /opt/tingyun-collector/conf/collector.yaml

如果输出为guanyun_enabled: false，请修改为：
```
guanyun_enabled: true
```
修改完成后，重启Collector服务：
```
systemctl restart tingyun-collector
```

方式二：安装Collector（若当前环境没有可用Collector）

登录观云平台。
在左侧导航栏点击全部应用，在打开的轻应用列表中点击部署状态。
在部署状态页面上方点击Collectors管理页签。
点击列表右上角的新增按钮，在打开页面中配置Collector参数：
- 必须开启Guanyun Collector：用于接收外部数据源产生的监控数据。
复制安装脚本，在目标机器上执行脚本完成Collector安装。

步骤三：申请数据库访问权限

为保证安全与最小权限原则，需在 MySQL 中创建只读账号并授予只读权限，仅用于数据采集。

创建监控账号

在 MySQL 主机上执行以下命令 (演示数据，请根据实际情况修改)：
```
CREATE USER 'tingyun_monitor_user'@'Collector IP' IDENTIFIED BY 'your_password';
```
参数说明：
- tingyun_monitor_user 为只读用户，可自定义名称。
- Collector IP 需替换为实际的Collector IP地址，不要使用 % 通配符，以限制来源主机。
- your_password 需更改为保密性比较高的密码串。

授予只读权限

根据需要限制访问的数据库和表，仅授予 SELECT 权限，仅开放目标数据库和特定表 (演示数据，请根据实际情况修改)：

GRANT SELECT ON example_db.static_day TO 'tingyun_monitor_user'@'Collector IP';
GRANT SELECT ON example_db.static_hour TO 'tingyun_monitor_user'@'Collector IP';
FLUSH PRIVILEGES;

步骤四：开通防火墙策略

确保Collector能够访问 MySQL 实例。请联系运维放开如下访问策略(演示数据，请根据实际情况修改)：

源地址	目标地址	目标端口	说明
Collector所在服务器	观云平台	80	Collector安装，向观云平台上传数据
Collector所在服务器	MySQL主机	3306	拉取 MySQL 数据

步骤五：配置数据源

登录观云平台。
在左侧导航栏点击全部应用，在打开的轻应用列表中点击数据集成。
在数据集成页面点击数据接入页签，并在外部数据区域点击Database。
在Database数据接入页面按提示填写连接参数，并重点确认以下信息后保存配置：
- 用户名/密码：步骤三中创建的MySQL只读监控账号和密码。
- Collector：步骤二中确认的Collector信息。

步骤六：生成数据库指标

在左侧导航栏点击全部应用，在打开的轻应用列表中点击指标体系。
点击生成指标，在打开的新增自定义指标页面完成以下配置：
- 数据源：选择步骤五中已配置的MySQL数据源。
- SQL查询：配置用于采集数据的查询语句。
- 新增指标：设置指标名称、单位、维度等参数。
点击右上角确定按钮，保存配置。

步骤七：查看报表

进入观云平台多维探索轻应用，选择模型为METRIC，查询上述配置中指标名对应的数据。

适配范围​

接入MySQL数据库的数据​

接入流程概述​

具体配置步骤​

步骤一：确认接入目标​

步骤二：准备或安装 Collector​

步骤三：申请数据库访问权限​

步骤四：开通防火墙策略​

步骤五：配置数据源​

步骤六：生成数据库指标​

步骤七：查看报表​