常见问题 agent监控安装失败
监控 agent 装不上？
监控 agent 安装失败的常见原因：架构包选错、依赖缺失、目标机没通网络到采集端、服务没自启，给装前装后核对清单。
发布于 2026/11/11
所属频道 银河麒麟
简短答案
agent 装不上基本四类：包架构与机器不符（ARM 机拿了 x86_64 包）、依赖没装齐、agent 到采集端网络不通、装完没设置自启导致重启后消失。装前核对架构与网络，装后核对服务状态。
现象对照表
| 现象 | 原因 |
|---|---|
| 安装时提示执行格式错误 / 架构不符 | 包选错架构 |
| 装时报缺库文件 | 依赖缺失 |
| 装上了但收不到数据 | 到采集端端口不通或被防火墙拦 |
| 重启后 agent 没跑 | 没设开机自启 |
排查步骤
# 机器架构
uname -m
# 包目标架构（本地 rpm 时）
rpm -qp 安装包.rpm | awk '{print $3}'
# 依赖缺失清单
rpm -qpR 安装包.rpm | xargs -I{} rpm -q {} 2>/dev/null || echo 缺
# 到采集端连通性
curl -sI http://采集端:端口
# 服务与自启
systemctl status agent服务名
systemctl is-enabled agent服务名处理办法
- 架构错：换与机器一致的包；基线参考 服务器 ARM 条目 或 x86_64 条目；
- 依赖缺：先装齐系统基础包，再装 agent；
- 网络不通：放通到采集端的端口，按行业规范最小化；
- 自启缺失：
systemctl enable补上； - 需要系统兜底时介质取 麒麟快捷入口 条目，写盘参考 Rufus 启动盘条目。
操作小结
- 装前：架构 + 网络两核对；
- 装后：服务状态 + 自启两确认；
- 缺依赖先补系统包；
- 批量部署先在一台验证再推广。