mirror of
https://github.com/hansjone/netx.git
synced 2026-10-20 07:23:22 +08:00
oliver
c1b1c0f75d
Evaluate keeps match keys for normalize/map pairing while diffs, reds, and the board show collected ports plus show-command provenance; add monitor-context and command-raw read APIs with biz-monitor:read scope. Co-authored-by: Cursor <cursoragent@cursor.com>
61 lines
2.5 KiB
Markdown
61 lines
2.5 KiB
Markdown
---
|
||
name: netx-biz-monitor
|
||
description: >-
|
||
Overnight cutover / biz_state monitor analysis via netxops host tools
|
||
(netx__getBizMonitor*). Given a project_id or task_id, read definitions,
|
||
board, reds/diffs with evidence (device-raw A/B, show commands), and judge
|
||
tool false-positive vs real business fault. Does not create templates/tasks.
|
||
---
|
||
|
||
# netx-biz-monitor（割接 / 业务监控只读分析）
|
||
|
||
人配好监控与任务；AI 当晚用 **project_id**（或 task_id）做归因。
|
||
工具在 **netxops**（`netx__*`），直连 netx REST，**不是** netx-mcp。
|
||
|
||
## 工具（能力组 `bizMonitor`）
|
||
|
||
| 工具 | 用途 |
|
||
|------|------|
|
||
| `netx__getBizMonitorContext` | 任务定义：项目、监控/对比模板、归一化规则、端口映射、关联任务与命令项 |
|
||
| `netx__getBizMonitorBoard` | 批次进度、evaluate run、sheet 卡、verdict 统计 |
|
||
| `netx__listBizMonitorReds` | 红单 + **evidence** |
|
||
| `netx__getBizMonitorDiffs` | run 明细（可滤 color=red） |
|
||
| `netx__getBizCollectBatch` | 某次采集：commands / metrics |
|
||
| `netx__getBizCollectCommandRaw` | 单命令全量 show 输出 |
|
||
|
||
交叉验证真障时再用 ops：`netx__execManagedNe` / 拓扑路径。
|
||
|
||
## 关键约定（必守）
|
||
|
||
- **`old_key` / `new_key`**：设备采集原文 **A/B**（大屏与结论用这个）
|
||
- **`match_*` / evidence.iface.normalized|map_***：内部配对，**不要**把映射后的 BB 说成两侧端口
|
||
- **evidence.*.command.raw_command**：实际 show 命令
|
||
- **evidence.*.device / collect**：哪台设备、何时采的
|
||
|
||
## 推荐顺序
|
||
|
||
1. `getBizMonitorContext(project_id)` — 弄清盯什么
|
||
2. `getBizMonitorBoard(batch_id)` — 进度 / missing / skipped
|
||
3. `listBizMonitorReds` 或 `getBizMonitorDiffs(color=red)`
|
||
4. 看 evidence：parse 失败？current_missing？映射 miss？归一化误伤？
|
||
5. 需要原文 → `getBizCollectCommandRaw`
|
||
6. 像真障 → `execManagedNe` 现场核对
|
||
|
||
## Verdict 速查（skill 解释，工具不硬编码）
|
||
|
||
| verdict | 含义（窗口内） |
|
||
|---------|----------------|
|
||
| migrated | expect 项已迁到新侧 |
|
||
| anomaly | 异常（多为红） |
|
||
| unfinished | expect 未完成（验收常红） |
|
||
| migrating / expected / ok | 过程态 / 正常 |
|
||
| lost / not_involved | 丢失或无关 |
|
||
|
||
## 误报优先查
|
||
|
||
1. `parse_status` 非 ok / 行数为 0
|
||
2. board：`current_missing` / `collect_skipped`
|
||
3. 端口映射漏配、归一化前后不一致导致假 anomaly
|
||
4. 再谈真实业务问题
|
||
|
||
配置整改与关红单由人做；本 skill **只读分析**。
|