# **1 Agent功能架构与简单介绍**
## 1.1 Agent简介
Agent是苍穹gPaaS托管中间件管理模块中的重要核心软件工具。其主要职责是运行在具体的服务端机器之上，并执行各种操作，以支持对苍穹中间件的可视化运维管理。这包括但不限于管理和监控MySQL、PostgreSQL、Redis、RabbitMQ、Zookeeper等关键中间件组件的状态、配置和性能。通过Kme-Agent，用户可以轻松地实现对这些中间件的远程管理，确保其稳定性、可用性和性能的高水平运行。无论是监视数据库的运行状态，还是中间件的部署方式，Kme-Agent都是苍穹gPaaS的不可或缺的工具，为企业提供了卓越的中间件管理体验。
## 1.2 Agent功能架构
Agent作为托管中间件管理模块的两大核心组件之一，在系统架构中扮演着关键的角色。它的核心功能如功能架构图所示。每个托管的主机上都运行着一个Agent进程，这个进程承担了多项重要任务：
- Agent负责与托管中间件建立联系和交互，确保它们的注册和状态监控。
- Agent承担着定期轮询的责任，以收集有关托管中间件的实时信息，包括实例心跳、备份心跳和恢复心跳等。这些信息汇总的过程对于全面的运维监控至关重要。
- Agent还承担着执行具体的托管中间件操作命令的任务。通过提供统一的、安全的接口，让管理员能够轻松地在多个主机和中间件实例之间进行操作，无需直接登录到每个主机。
Agent的工作流程大致可以分为以下几步，以确保高效的运行和对若干中间件实例的可控管理：
1. **Agent部署与启动**：KME会向目标机器发送Agent二进制文件，并启动Agent。
2. **监听请求**：Agent一旦启动，便开始持续监听9990端口，等待来自KME的各种请求。这些请求多种多样，包括但不限于以下几种以确保Agent能够满足多种运维需求。
- 中间件实例注册请求
- 中间件实例启动、停止、重启请求
- 中间件实例备份、恢复请求
- 日志获取请求
……
3. **实例信息管理**：当Agent成功处理并执行了这些请求后，它会将注册成功的实例信息进行永久化保存，并将它们添加进执行循环（LOOP）。这个LOOP是一个关键组件，用于跟踪和管理所有注册的中间件实例。
4. **定时心跳**：为了保持与KME的连接和实时信息同步，Agent会定时触发心跳操作。Agent会向KME发送Ping请求，并上报实例信息，以确保在管理过程中的稳定性和可用性。
Agent的设计采用了模块化结构，这意味着它的功能可以根据需要进行定制和扩展。这种设计理念使得它能够轻松适应不断变化的中间件环境，并在未来兼容更多类型的中间件，以满足不断增长的管理需求，为企业提供了强大的中间件管理能力。
# 2 Agent的安装与维护
## 2.1 安装目录
目前通过苍穹gPaaS安装的托管中间件主机和非苍穹gPaaS安装的托管中间件主机，只要满足配置需求均可安装Agent，未安装Agent的托管主机可在中间件管理模块的页面中手动安装Agent。Agent的安装目录位于托管主机上的以下路径：
`/usr/local/kme-agent`
在安装Agent之前，请确保您具有超级管理员权限。安装Agent的过程非常简单，您只需进入gPaaS平台托管中间件模块主机对应的区域，点击安装Agent选项，并在提示下输入主机的用户名和密码即可成功安装Agent。
一旦Agent安装完成，它将开始主动收集系统信息并监听端口9990，以便响应来自管理控制台的请求。此外，在某些特殊情况下，您还可以根据需要对Agent进行进一步的配置，包括调整其参数和插件，以满足特定的监控和管理需求。这确保了您能够根据实际情况对Agent进行定制化设置，以最大程度地满足您的监控和管理要求。
## 2.2 查看日志
为了方便手工维护Agent，我们提供了查看Agent运行日志的渠道，Agent的运行日志路径为：
`/usr/local/kme-agent/log/`
您可以使用以下命令查看Agent运行日志文的最新100行的内容：
`tail -f -n 100 /usr/local/kme-agent/log/kme-agent.log`
