Add netx UME NE inventory tools for ops

Expose netx_query_ume_ne_inventory and netx_get_ume_ne (GET /v1/ume/inventory/ne and /ne/{id}). Update ops playbook, ROLE_SYSTEM, env example comment, and unit tests.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
oliver 2026-05-11 17:24:57 +08:00
parent 939a734e76
commit 1c90a3570e
6 changed files with 146 additions and 8 deletions

View file

@ -1,13 +1,13 @@
---
name: ops-netx-ume-playbook
description: 面向 ops 专家的 netx UME 告警分析标准作业手册。用于任何告警查询、聚合统计、诊断摘要、raw 字段过滤与 UME SQL 分析场景。
description: 面向 ops 专家的 netx UME 运维作业手册。覆盖告警查询/聚合/诊断、网元清单与单网元详情、raw 字段过滤与 UME 只读 SQL。
---
# Ops Netx UME 作业手册
## 强制使用范围
凡是涉及 netx/UME 告警的 ops 请求,必须优先加载并遵循本技能。
凡是涉及 netx/UME **告警**或 **网元信息** 的 ops 请求,必须优先加载并遵循本技能。
## 工具选择顺序
@ -22,6 +22,9 @@ description: 面向 ops 专家的 netx UME 告警分析标准作业手册。用
- `netx_aggregate_ume_alarms_raw`(`group_by`,可选 `group_by2`)
4. 高级分析(SQL):
- `netx_sql_query_ume`(仅 SELECT、仅 UME 表;重查询建议设置 `statement_timeout_ms`)
5. **网元(inventory,与 netx「网元清单」同源)**:
- 列表/搜索:`netx_query_ume_ne_inventory`(`keyword` + 分页)
- 单条详情(含 `raw_json`):`netx_get_ume_ne`(`ne_id` = UUID)
## 快速决策树(强推荐)
@ -35,6 +38,9 @@ description: 面向 ops 专家的 netx UME 告警分析标准作业手册。用
- `netx_aggregate_ume_alarms_raw`(`group_by` / `group_by2`)
- **需要复杂条件 / 自定义计算 / 多条件关联**:
- `netx_sql_query_ume`(必须过滤 + `statement_timeout_ms`)
- **查网元是谁、IP/标签、在线状态、或核对告警里的 ne_id**:
- 先 `netx_query_ume_ne_inventory`(`keyword` 可填名称片段或 UUID 片段)
- 需要完整字段与 `raw_json` 时再 `netx_get_ume_ne`
## 约束与护栏

View file

@ -43,6 +43,14 @@
- 工具:`netx_run_ume_diagnostics`
- 用途:在深挖前先快速形成“概览简报”(严重度、Top 网元、Top 事件类型等)
## 4b) 网元清单与详情
- 工具:`netx_query_ume_ne_inventory` — 对应 netx `GET /v1/ume/inventory/ne`
- 参数:`keyword`(可选,匹配 ne_id/ne_name/user_label/ip)、`page`、`page_size`(最大 500)
- 工具:`netx_get_ume_ne` — `GET /v1/ume/inventory/ne/{ne_id}`
- 参数:`ne_id`(UUID,与清单字段一致)
- 与告警 raw 中的 `ne_*` 字段互补:需要 UME 原始 JSON 时用 `netx_get_ume_ne` 的 `raw_json`。
## 5) SQL 深度分析(受限)
- 工具:`netx_sql_query_ume`