mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-08 23:33:16 +08:00
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:
parent
939a734e76
commit
1c90a3570e
6 changed files with 146 additions and 8 deletions
|
|
@ -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`
|
||||
|
||||
## 约束与护栏
|
||||
|
||||
|
|
|
|||
|
|
@ -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`
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue