Monitor 安装

前面已经把 Ambari Plus 主体平台、基础组件、IoTDB 和 Monitor 元数据库 DDL 准备好，这里开始安装 AMBARI_PLUS_MONITOR 服务。Monitor 本身由 Platform API、Ingester、Rule Engine 和 Agent 组成：API 提供监控后端入口，Ingester 接收和写入指标，Rule Engine 负责规则计算，Agent 分布在主机上采集基础指标。

本文继续使用三台 FQDN 主机：

主机	本次 Monitor 角色
hadoop1.test.com	AMBARI_PLUS_INGESTER、AMBARI_PLUS_AGENT
hadoop2.test.com	AMBARI_PLUS_PLATFORM_API、AMBARI_PLUS_AGENT
hadoop3.test.com	AMBARI_PLUS_RULE_ENGINE、AMBARI_PLUS_AGENT

安装前先确认两件事：

前置项	文章
IoTDB 已启动	IoTDB 安装与部署
Monitor 元数据库已初始化	【必须】ambari plus monitor 数据库初始化文件

提示

本文数据库示例继续使用 MySQL / MariaDB，地址是 hadoop1.test.com，演示账号为 root / root。生产环境建议使用高复杂度密码和专用账号。

Ambari Plus 3.0.3

3.0.3 的 Monitor 配置页支持 IoTDB 单节点与集群入口，也支持客户自建运行用户。页面会根据是否自动创建数据库给出对应授权语句，并在安装前检查连接、数据库和有效权限。

1. 选择 Ambari Plus Monitor 服务

进入 服务与组件，点击 新增服务。在服务列表里勾选 Ambari Plus Monitor VIP，版本显示为 1.0.0。

这个服务不要和其他大组件混在一起安装。Monitor 涉及元数据库、IoTDB、KDC 凭据和多个运行角色，单独安装更容易定位问题。

2. 确认 Master 分配

进入 Master 分配页后，页面会自动给三个 Master 角色选择主机。

本文环境使用下面的分配方式：

组件	主机	说明
AMBARI_PLUS_INGESTER	hadoop1.test.com	接收 Agent 指标并写入 IoTDB。
AMBARI_PLUS_PLATFORM_API	hadoop2.test.com	提供 Monitor 后端 API。
AMBARI_PLUS_RULE_ENGINE	hadoop3.test.com	负责阈值规则计算。

小集群里这样拆开角色，方便看清各组件职责。生产环境可以再结合资源、可用性和访问入口做独立规划。

3. 确认 Agent 覆盖主机

Slave 分配页会出现 AMBARI_PLUS_AGENT。这里建议三台主机全部勾选，让 Monitor 能采到每台机器的基础指标。

本文分配结果如下：

组件	主机
AMBARI_PLUS_AGENT	hadoop1.test.com、hadoop2.test.com、hadoop3.test.com

如果后续新增主机，也要记得给新主机补装 Agent，否则服务能运行，但主机指标会缺口。

4. 填写元数据库连接

进入自定义配置页后，先看 元数据库 页签。本文让 Monitor 元数据库跟随 Ambari Server 数据库实例，库名仍然是 ambari。

本次填写如下：

配置项	本文示例值	说明
跟随 Ambari Server 数据库实例	开启	Monitor 表和 Ambari 官方表放在同一个 ambari 库。
元数据库类型	MySQL	MariaDB 也按 MySQL 类型填写。
元数据库地址	hadoop1.test.com	使用 FQDN。
元数据库端口	3306	MySQL / MariaDB 默认端口。
元数据库名称	ambari	前面已经导入 Monitor DDL 的库。
元数据库用户	root	教程环境演示用。
元数据库密码	root	教程环境演示用，页面里会隐藏显示。

这里最容易填错的是库名。Monitor DDL 必须导入 ambari，向导里也要填写 ambari，两边保持一致。

5. 填写 IoTDB 连接

切换到 IoTDB 存储 页签，填写前面 IoTDB 文章里准备好的连接信息。

5.1 选择连接模式

本文使用单节点入口，填写 hadoop1.test.com:26667。如果 IoTDB 已经部署为集群，可以选择集群模式，并填写多个 DataNode RPC 地址；Monitor 会使用节点列表建立连接池。

配置项	本文示例值	说明
IoTDB Connection Mode	单节点 IoTDB	集群部署时选择高可用 IoTDB 集群。
IoTDB Host	hadoop1.test.com	IoTDB DataNode 所在主机。
IoTDB Port	26667	DataNode RPC 端口。
IoTDB 运行用户	root	教程环境使用默认用户；生产环境可以填写客户自建用户。
IoTDB 运行用户密码	root	教程环境使用默认密码，页面里会隐藏显示。
IoTDB 指标数据库	root.monitor	Monitor 指标写入的数据库路径。
启动时自动创建 IoTDB 数据库	开启	教程环境由 Monitor 自动创建；生产环境使用专用用户时建议改为关闭。

集群模式下不再填写单个 Host 和 Port，而是在 IoTDB Cluster Node URLs 中按逗号分隔多个入口，例如：

iotdb1.test.com:26667,iotdb2.test.com:26667,iotdb3.test.com:26667

5.2 使用客户自建用户 3.0.2+

3.0.2 支持把 Monitor 的 IoTDB 运行账号从 root 换成客户自建用户。生产环境推荐由管理员提前创建 root.monitor，然后关闭 启动时自动创建 IoTDB 数据库。这种模式下，运行用户不需要 MANAGE_DATABASE，只需要指标路径的最小权限：

GRANT READ_DATA, WRITE_DATA, READ_SCHEMA, WRITE_SCHEMA
ON root.monitor.** TO USER monitor_user;

也可以先把权限授给角色，再把角色分配给用户：

GRANT READ_DATA, WRITE_DATA, READ_SCHEMA, WRITE_SCHEMA
ON root.monitor.** TO ROLE IOTDB;

GRANT ROLE IOTDB TO monitor_user;

如果保持自动创建开启，还需要额外授权：

GRANT MANAGE_DATABASE ON root.** TO USER monitor_user;

注意

授权路径要写成 root.monitor.**，不能只写 root.monitor。Monitor 会在该数据库下面继续创建主机、服务和指标时序，精确路径授权无法覆盖这些子路径。

完整的建库、角色和用户准备步骤可以回到 IoTDB 安装与部署 查看。

5.3 测试连接与权限

填写完成后，点击 测试 IoTDB 连接与权限。这项预检使用页面当前账号做只读检查，不会创建测试时序，也不会向客户指标空间写入测试数据。

页面会逐项确认：

检查项	通过标准
连接与认证	可以连接 IoTDB，并能读取版本信息。
目标数据库	root.monitor 已存在；或者已开启自动创建。
指标读写权限	用户直接权限或角色继承权限中，包含 root.monitor.** 的 READ_DATA、WRITE_DATA、READ_SCHEMA、WRITE_SCHEMA。
自动建库权限	仅在自动创建开启时要求 root.** 上的 MANAGE_DATABASE。

页面显示 预检通过 后再继续安装。若用户名刚从原账号改成自建用户，需要重新输入新用户密码；页面不会拿旧账号保存的密码去测试新用户。

完成 IoTDB 预检后再点击 重新校验。顶部显示 待填写 0，并且配置项为已推荐状态，就可以进入下一步。

6. 通过配置校验

配置页顶部会显示本次配置校验结果。本文环境中 待填写 为 0，说明必填项都已经补齐。

如果这里还有待填写项，不要直接跳过。建议先用搜索框定位配置名，把数据库、IoTDB、端口、用户和密码补齐后再继续。

7. 确认安装清单

确认页会汇总新增服务、Master、Slave 和配置检查结果。

本次确认结果如下：

检查项	本次结果
新增服务	AMBARI_PLUS_MONITOR
Master 分配	Ingester、Platform API、Rule Engine 分别放到三台主机。
Agent 分配	三台主机全部安装 Agent。
元数据库	hadoop1.test.com:3306/ambari
IoTDB	hadoop1.test.com:26667/root.monitor

确认无误后点击 开始安装。

8. 提交 KDC 管理员凭据

当前集群已经开启 Kerberos，新增 Monitor 时会弹出 KDC 管理员凭据窗口。这里填写的是 KDC 管理员 Principal 和密码，用于生成 Monitor 组件需要的 principal 与 keytab。

密码在页面里会隐藏显示。提交后，向导会继续执行安装任务。

9. 等待安装进度

安装进度页会按主机展示任务。可以看到三台主机都在执行 AMBARI_PLUS_AGENT 安装，同时 Master 组件会按分配主机依次安装。

这一页重点看失败数。如果失败数一直是 0，任务会继续向后推进；如果某台主机失败，先点开该主机的 日志，通常能看到数据库连接、IoTDB 连接、KDC 凭据或 RPM 包安装相关错误。

10. 安装后确认服务状态

安装完成并启动服务后，回到 服务与组件，搜索 AMBARI_PLUS_MONITOR。服务卡片里可以看到四个组件均为运行中。

本文环境里确认到：

组件	状态
Ambari Plus Platform API	运行中
Ambari Plus Ingester	运行中
Ambari Plus Rule Engine	运行中
Ambari Plus Agent	运行中

我还会在服务端确认配置已经写入运行目录，重点看元数据库、IoTDB 和 storage group。

到这里，Ambari Plus Monitor 的安装链路就完成了。下一篇可以继续进入 Monitor 的日常使用：看指标采集、阈值策略、通知渠道和告警历史。