IMC 纳管 UIS，Trap 告警虚拟机名称对不上完整调试方案

一、先理清根因（名称不一致 4 大类根源）

1. MIB 缺失 / 不全，Trap 只上报 VM UUID，没解析出虚拟机名称
   UIS 私有 Trap 报文里同时携带虚拟机 UUID、虚拟机显示名，IMC 缺少完整 UIS MIB 时，只会读取 UUID，无法匹配真实虚拟机名称，告警里只显示一串 ID，和 UIS 页面名称完全不符。
2. UCenter APM (MVM) 虚拟化纳管同步缓存失效
   MVM 模块会定时拉取 UIS 全量虚拟机清单存入数据库做名称映射；采集中断、纳管异常、缓存脏数据，会导致 Trap 里的 UUID 查不到对应虚拟机中文名。
3. Trap 升级告警模板未绑定虚拟机名称字段
   自动生成的 Trap 转告警规则只提取故障描述，没配置展示虚拟机名称 OID，告警摘要只打印 UUID，不展示虚拟机可读名称。
4. 两套告警源冲突：硬件 Trap + 虚拟化 Trap 两套逻辑
   UIS Manager 推送全局 SNMP Trap（硬件 + 虚机告警）、MVM 主动 API 轮询虚拟化数据，两套数据源不同步，名称来源不一致。

二、分步调试修复（按顺序操作）

步骤 1：重新导入完整 UIS 配套 MIB（最核心）

1. 进入 IMC【资源】→【SNMP 管理】→【MIB 管理】
2. 删除所有旧的 UIS/CAS 相关 MIB 文件（残缺 MIB 会丢失名称 OID）
3. 下载和你当前 UIS 版本完全匹配的全套 MIB 压缩包（不要单独导入单个文件）
4. 批量上传全部 MIB，点击【编译 MIB】，确认无编译报错；有报错会直接丢弃虚拟机名称字段解析
5. 编译完成后重启服务：iMC Trap Receiver、UCenter APM
6. 验证：打开 IMC iMC/client/log/trap/trap.log，抓取一条虚机告警 Trap，日志里必须同时出现vmName、vmUUID两个字符串字段，只有 UUID 代表 MIB 缺失。

步骤 2：修复 UCenter APM 虚拟化纳管，刷新虚拟机名称映射库

1. 进入【UCenter APM】→【虚拟化管理】→【集群】，找到你的 UIS 集群
2. 点击【同步集群资源】，强制全量同步虚拟机、主机、存储清单
3. 等待同步完成，查看虚拟机列表，确认所有虚拟机名称、UUID 和 UIS 平台完全一致
4. 若同步失败：删除该 UIS 集群纳管实例，重新填写 UIS Manager 账号密码、端口重新纳管
5. 缩短采集周期：【UCenter APM】→【系统配置】→采集参数，虚拟化采集间隔改为 5 分钟，避免缓存过期。

步骤 3：修改 Trap 升级告警模板，强制展示虚拟机真实名称

1. 【资源】→【陷阱管理】→【陷阱升级告警配置】
2. 筛选 UIS 设备产生的所有虚机类 Trap 规则，逐条编辑
3. 告警摘要 / 详情模板中，手动添加虚拟机名称 OID 变量（UIS MIB 里vmName对应字段）
   • 原始模板大概率只写故障类型、UUID；修改后模板示例：虚拟机【${vmName}】(UUID:${vmUUID})发生内存使用率过高告警
4. 全部规则启用，保存，重启 Trap 接收服务
5. 触发一条虚拟机告警测试，告警详情里必须出现可读虚拟机名称，不再只显示 UUID。

步骤 4：区分两套告警源，统一名称来源

1. 虚拟化业务告警（CPU / 内存 / 磁盘 / 虚拟机开关机）
   优先走 MVM 纳管采集，API 同步虚拟机名称，数据最准；Trap 仅做事件触发，名称以 MVM 映射库为准。
2. 硬件告警（硬盘、风扇、电源、CVK 主机故障）
   UIS Manager 推送 SNMP Trap，依赖完整 UIS MIB 解析主机名称，无需 MVM 映射。
3. 禁止双重复推送：不要同时在 CVK 主机 HDM 单独配置 Trap + UIS Manager 全局 Trap，避免重复告警、名称两套标准。

步骤 5：抓包 + 日志定位调试（快速定位是报文缺字段还是 IMC 解析问题）

1. 抓包验证 UIS 发出来的 Trap 是否带虚拟机名称

• 存在vmName字符串：问题在 IMC MIB / 模板 / 映射缓存
• 只有 UUID 无vmName：UIS 侧 SNMP 配置问题，联系 UIS 后台确认告警 Trap 字段下发完整。

2. 查看 IMC Trap 原始日志区分解析故障
   路径：iMC/server/log/trap/trap.log

• 日志打印vmName=xxx虚拟机名称：报文正常，只是告警模板没展示名称，改模板即可
• 日志只有vmUUID=xxxx无名称：MIB 未正确加载，回到步骤 1 重新导入 MIB。

步骤 6：兜底缓存清理（同步后名称依旧错乱执行）

1. 停止iMC Trap Receiver、UCenter APM服务
2. 删除 Trap 缓存目录：iMC/server/tmp/trap/*
3. 清理 MVM 虚拟化内存缓存，重启两个服务
4. 再次同步 UIS 集群虚拟化资源，复现告警测试。

三、快速判断根因对照表

四、标准操作顺序（现场直接套用）

1. 抓包确认 UIS Trap 报文是否携带虚拟机名称字段
2. 删除旧 MIB，上传 UIS 对应完整 MIB 并编译无报错，重启 Trap 服务
3. UCenter APM 删除 UIS 集群重新纳管，强制同步全量虚拟机资源
4. 修改 Trap 升级告警模板，增加虚拟机名称展示字段
5. 清理 Trap 缓存，重启 Trap 与 APM 服务
6. 手动触发 UIS 虚拟机告警，验证 IMC 告警名称与 UIS 一致