# AIOps-电信数通智能运维技能包

## 概述
面向电信/数通网络的 AI 智能运维技能包。支持告警日志智能分析、配置错漏检查、故障模式学习与根因推荐。适用于华为、中兴、Cisco、Juniper 等主流数通设备。

## 能力说明

### 1. 告警日志智能分析

#### 1.1 输入格式支持
- Excel/CSV 格式的告警清单（如网管导出的告警报表）
- 纯文本格式的 syslog/告警日志
- 设备 CLI 输出的告警信息

#### 1.2 分析维度

| 维度 | 说明 |
|------|------|
| **告警分级统计** | Critical / Major / Warning 级别分布及占比 |
| **设备维度聚合** | 按设备（ME/NE）统计告警数量 Top N |
| **告警类型归类** | 物理层/链路层/网络层/路由层/安全层分类 |
| **时间维度分析** | 告警爆发时间窗口、频次趋势 |
| **关联分析** | 同设备/同链路的多层告警关联，推测根因 |
| **影响评估** | 评估受影响业务（L3VPN/Tunnel/Ethernet）范围 |

#### 1.3 告警类型知识库

##### 物理层告警
| 告警名称 | 级别 | 含义 | 常见根因 | 推荐操作 |
|----------|------|------|---------|---------|
| Ethernet Physical LOS | Critical | 光口信号丢失 | 光纤断/松、光模块故障、对端设备断电 | 检查光纤链路、光功率、更换光模块 |
| Ethernet Physical Laser Temperature | Major | 激光器温度越限 | 光模块老化、设备散热不良、环境温度过高 | 检查设备风扇/温度、更换光模块 |
| Ethernet Physical Input Optical Power | Major | 接收光功率越限 | 光纤衰减过大、接口脏污、对端发光异常 | 清洁光纤接头、检查光功率预算 |
| Ethernet Physical CRC Error | Major | CRC 误码越限 | 光纤质量差、接头污染、电磁干扰 | 清洁光纤、检查物理链路、更换尾纤 |
| SmartGroup RX CRC Error | Major | 聚合口 CRC 误码 | 聚合成员链路质量问题 | 排查各成员链路、更换问题链路 |

##### 路由/MPLS层告警
| 告警名称 | 级别 | 含义 | 常见根因 | 推荐操作 |
|----------|------|------|---------|---------|
| OSPF Neighbor Down | Major | OSPF 邻居中断 | 物理链路故障、Hello 超时、配置不匹配 | 检查邻居间链路、验证 OSPF 配置参数 |
| RSVP LSP BFD Session Down | Major | MPLS TE隧道 BFD 检测失败 | 隧道途经链路故障、节点故障 | 检查隧道路径、确认中间节点状态 |
| BGP Peer Flap | Major | BGP 邻居震荡 | 链路不稳、Keepalive 超时、策略变更 | 检查 BGP 配置、链路稳定性 |

##### 安全/控制面告警
| 告警名称 | 级别 | 含义 | 常见根因 | 推荐操作 |
|----------|------|------|---------|---------|
| CPSBP 超阈值 | Warning | 控制面报文速率超阈值 | 攻击流量、广播风暴、配置过低 | 分析流量源、调整 CP 保护阈值 |
| ARP IP冲突 | Warning | 检测到 IP 地址冲突 | 私接设备、IP 配置错误 | 定位冲突源、释放/更改 IP 地址 |

### 2. 配置错漏检查

#### 2.1 支持检查项

| 检查类别 | 典型检查项 |
|----------|-----------|
| **接口配置** | VLAN 配置一致性、MTU 匹配、描述规范、端口模式(access/trunk) |
| **路由协议** | OSPF area 一致性、BGP AS 号核对、Route-map 逻辑、邻居配置完整性 |
| **MPLS/TE** | LSP 配置完整性、隧道保护策略、FRR 配置 |
| **安全策略** | ACL 规则匹配、控制面保护(CoPP)、端口安全、MAC 漂移检测 |
| **高可用** | VRRP/HSRP 配置一致性、BFD 联动、链路聚合(LACP)配置 |
| **QoS** | 队列策略、带宽限制、优先级映射 |

#### 2.2 分析模式
- **配置比对**：新旧配置 diff，快速定位变更点
- **合规检查**：基于标准模板检查配置是否符合规范
- **逻辑验证**：检查配置逻辑矛盾（如 ACL 冗余/冲突、路由黑洞）

### 3. 故障模式学习 (self-learning)

系统会记录每次分析过程中的：
- 告警 → 修复措施 对应关系
- 配置错误 → 正确配置 修正方案
- 经用户确认的根因分析结论

这些 learnings 会存入 `.learnings/` 目录，在后续分析中自动参考，越用越准确。

## 使用示例

### 示例1：告警日志分析
```
用户: "分析这份告警日志"
助手: 按以下格式输出分析报告：

📊 告警概览
- 总告警数：24条
- Critical：2条 (8.3%) ⛔
- Major：9条 (37.5%) ⚠️
- Warning：13条 (54.2%) ⚡

🔴 Critical 告警详情
1. [SMD-LIIR-EN1-Z20HS] ETPI LOS → 物理光口信号丢失
   → 该设备下联 SMD-SBRS-EN1-Z20HS，状态 Unack
   → 建议：立即检查光纤/光模块

🟠 Major 告警详情
1. [BKL-UNB-AN1-ZM3SP] 光功率越限 → 接收光功率过低
2. [MDN-PMKN-EN1-Z20HS] 激光器温度越限
3. [PAD-KBU-AN1-ZM8S] CRC误码越限（物理口+聚合口）
4. RSVP LSP BFD Session Down ×3条
5. OSPF邻居中断 ×2条

🔄 关联分析发现
- PBR-RPKU 与 PBR-PYSK 之间：OSPF邻居中断 + CPSBP告警
  → 推测该链路存在物理层问题
- GRO 站点多条 RSVP LSP BFD Down
  → 可能为 GRO 节点设备问题或出局光缆中断

💡 根因推荐
1. 优先处理 SMD-LIIR-EN1-Z20HS 的 LOS（Critical）
2. 检查 PBR-RPKU ↔ PBR-PYSK 链路光功率和光模块
3. 排查 GRO 站点汇聚设备状态
```

### 示例2：配置检查
```
用户: "帮我检查这两份配置文件"
助手: 
🔍 配置检查报告
1. OSPF 配置检查 ✅
   - Area 一致性：匹配
   - Hello/Dead 间隔：一致
   - 网络类型：一致

2. 接口配置检查 ⚠️
   - [GE0/0/1] MTU 不匹配：本端 1500，对端 9000
   - [GE0/0/2] 描述缺失

3. BGP 配置检查 ❌
   - AS 号不匹配：本端 AS65001，对端 AS65002
```

## 数据来源说明

本技能的知识库基于以下标准构建：
- 华为 NE40E/ME60 系列告警手册
- 中兴 ZXR10 系列告警与配置规范
- 3GPP 管理面标准（IRP/Solution）
- ITU-T 光传输标准
- RFC 相关协议标准

## 局限性与注意事项
- 本技能不直接连接设备执行命令，不做配置变更操作
- 分析结果基于提供的日志/配置数据，用户需确认数据准确性
- 推荐操作为参考建议，重大操作需人工复核