UC告警添加接口描述
- 0关注
- 0收藏，75浏览
以下是通用的排查与配置思路：
1. 确保设备侧配置（前提）
确保被监控的网络设备（交换机/路由器）接口下已配置 description。
interface GigabitEthernet1/0/1
description To_User_xxx
2. IMC/U-Center 平台操作（核心）
如果是在 IMC/U-Center 中查看告警：
1. 同步资源： 进入“资源”页签 -> 找到该设备 -> 点击“同步”或“重新同步”，确保 IMC 已采集到最新的接口描述。
2. 告警通知内容定制（四段式/详情）：
进入“告警”页签 -> 告警设置 -> 通知内容模板。
编辑或新增模板。
在“变量”列表中，找到 接口描述 (IfDesc) 或类似变量（通常包含 Desc/Description 字段），将其添加到模板内容中。
保存模板，并在对应的“告警规则”或“告警通知”中应用该模板。
3. 如果是特定语音网关
如果是指设备本身的日志/告警：通常系统日志（Syslog）中会自动包含接口名，但如需关联描述，需依赖网管系统解析，设备本身 CLI 一般仅支持通过 display alarm urgent 查看，不带四段式自定义。
建议： 登录新华三官网（www.h3c.com.cn），在“服务支持”-“文档中心”搜索对应产品的“告警配置指导”。
可选配置参数：网管站：$(NMSSour)、告警源：$(FaultSour)、告警名称：$(FaultName)、严重程度：$(FaultLevel)、告警时间：$(FaultTime)、告警描述：$(FaultDesc)、持续时间：$(Duration)、告警源IP：$(FaultDevIp)、告警源名称：$(FaultDevName)、是否挂牌：$(FaultHoldInfo)、是否是恢复告警：$(FaultIsRecover)仅支持以上参数。 接口别名存在且正常获取的，目前5.0告警内容中不包含别名
U‑Center5.0 接口告警分两类：设备主动上送 Trap 告警（接口 UP/DOWN）、UC 平台内部生成阈值告警（带宽、错包）；二者带出接口描述
if‑alias逻辑不一样H3C。
一、前提条件（必须先满足）
1、交换机设备接口下配置description xxx，配置真实接口描述；
2、纳管设备 SNMP 模板要开启读取ifAlias(OID:1.3.6.1.2.1.31.1.1.1.18)，设备 SNMP 读写团体具备该 MIB 节点访问权限；
3、设备在 UC 上执行重新同步设备接口信息：
【管理】‑【基础资源管理‑资源列表】点开设备→【接口列表】→点右上角同步接口，把设备上description同步进 UC 数据库，UC 内部接口库拿到接口别名数据H3C。
重要区分：
- Trap 类告警（设备侧主动上报 link‑down）：要看 Trap 报文本身是否携带 if‑alias 字段；H3C 设备原生 IF‑LINKDOWN trap默认不带接口描述，只携带接口索引 ifIndex，UC 收到原始 trap 本身没有描述字段。
- UC 内部阈值告警（带宽、错包等 IOM 阈值告警）：UC 拿到 ifIndex 后，会去本地接口数据库查表回填已经同步好的接口描述，这类告警详情里面可以展示接口描述。
二、两种告警分别怎么带出接口描述
1、接口 UP/DOWN（设备 trap 上送）
原生标准IF‑MIB::linkDowntrap 报文只有 ifIndex，设备不会把 description 封装在 trap 里面，不能直接修改 trap 报文增加描述字段。
两种实现方案：
- 方案 A（推荐，E7302 及以上版本）：修改告警转换脚本（告警模版），当收到 link‑down trap，UC 根据报文中的
ifIndex，查询平台已经同步好的接口数据库，把接口别名回填到告警详情里面。 操作路径：【告警】‑【告警配置】‑【告警转换】，找到对应 linkDown trap 的告警模板，修改告警消息模板，增加$interfaceAlias变量。
老版本 UC 不支持该变量，只能告警详情页查看，告警列表简短信息无法展示别名。
- 方案 B：交换机设备侧使用 H3C 私有 Trap，部分版本私有 linkdown trap 携带接口别名；但兼容性一般，不推荐。
2、IOM 阈值告警（带宽、错包、丢包等平台计算产生告警）
只要已经做过【同步接口】把 ifAlias 同步到 UC 数据库，阈值告警告警详情默认自带接口描述，无需额外修改模板。
如果这里看不到接口描述，绝大多数是没有执行接口同步，或者 SNMP 权限读不到 ifAlias 节点。
三、排查步骤（看不到接口描述按这个查）
1、在设备接口配置好description；确认 SNMP 可以读取 ifAlias，可使用 MIB 浏览器测试 OID：1.3.6.1.2.1.31.1.1.1.18。
2、U‑Center 资源列表进入该设备，接口列表点【同步接口】，同步完成后，检查页面接口列表里面 “接口描述” 列已经显示设备配置的 description，确认同步成功H3C。
3、阈值告警：重新触发告警，打开告警详情，看是否出现接口描述；没有出现检查 IOM 监控模板是否正常采集接口对象。
4、接口 UP/DOWN trap 告警：
- 查看【告警】‑【Trap 浏览】看原始 trap 报文内容，原始 trap 报文本身没有接口描述，就只能依靠告警转换模板，用 ifIndex 回填接口别名。
- 如果 UC 版本过低不支持
$interfaceAlias变量，则告警列表简短信息无法展示接口描述，只能点开告警详情‑关联资源，跳转设备接口页面查看 description。
四、常见踩坑点
1、只在 UC 页面手工填写接口备注：【接口列表】编辑接口描述，这个是 UC 本地备注，不会从设备读取，trap 告警不会识别，设备重启重新同步接口会被覆盖，优先在交换机命令行配置 descriptionH3C。
2、同步接口操作只是一次性动作，设备接口 description 修改后，必须再次点【同步接口】，UC 数据库才会更新。
3、低版本 U‑Center（E72xx 早期版本）告警转换模板不支持$interfaceAlias变量，列表栏不能直接展示接口别名，需要升级版本。
小结
1、IOM 阈值告警：做好 SNMP 权限 +【同步接口】，告警详情自带接口描述。
2、接口 UP/DOWN Trap 告警：原生标准 trap 报文不带接口描述；高版本 UC 修改告警转换模板，使用$interfaceAlias变量，根据 ifIndex 回填同步好的接口别名；老版本只能点开告警详情跳转接口页面查看描述。
3、不要只在 UC 网页上手动填写接口备注，优先交换机 CLI 配置description，再同步接口。
编辑答案
亲~登录后才可以操作哦!
确定你的邮箱还未认证，请认证邮箱或绑定手机后进行当前操作
举报
×
侵犯我的权益
×
侵犯了我企业的权益
×
- 1. 您举报的内容是什么？（请在邮件中列出您举报的内容和链接地址）
- 2. 您是谁？（身份证明材料，可以是身份证或护照等证件）
- 3. 是哪家企业？（营业执照，单位登记证明等证件）
- 4. 您与该企业的关系是？（您是企业法人或被授权人，需提供企业委托授权书）
抄袭了我的内容
×
原文链接或出处
诽谤我
×
- 1. 您举报的内容以及侵犯了您什么权益？（请在邮件中列出您举报的内容、链接地址，并给出简短的说明）
- 2. 您是谁？（身份证明材料，可以是身份证或护照等证件）
对根叔社区有害的内容
×
不规范转载
×
举报说明
可选配置参数：网管站：$(NMSSour)、告警源：$(FaultSour)、告警名称：$(FaultName)、严重程度：$(FaultLevel)、告警时间：$(FaultTime)、告警描述：$(FaultDesc)、持续时间：$(Duration)、告警源IP：$(FaultDevIp)、告警源名称：$(FaultDevName)、是否挂牌：$(FaultHoldInfo)、是否是恢复告警：$(FaultIsRecover)仅支持以上参数。 接口别名存在且正常获取的，目前5.0告警内容中不包含别名