hansjone/netx
1
0
Fork 0
mirror of https://github.com/hansjone/netx.git synced 2026-10-08 23:33:21 +08:00
Code Issues Projects Releases 1 Packages Wiki Activity Actions 2

Document biz_state light/heavy collect timeout env vars.

Browse source 
Add dual-lane READ vs RUN_TIMEOUT_CAP notes to .env.example and WEB.md so operators can raise the ~40min heavy cap.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
oliver 2026-09-22 19:14:16 +08:00
parent 924f9bd2f7
commit b453c6871e
2 changed files with 14 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

9
.env.example
View file

@ -75,6 +75,15 @@ NETX_UME_NOTIFICATION_TOPIC=ALARM
# NETX_BIZ_STATE_WORKER_REPLICAS=2 # NETX_BIZ_STATE_WORKER_REPLICAS=2
# NETX_BIZ_STATE_SPOOL_DIR=data/biz_state_spool # NETX_BIZ_STATE_SPOOL_DIR=data/biz_state_spool
# NETX_BIZ_STATE_PERSIST_EVERY_CMDS=8 # NETX_BIZ_STATE_PERSIST_EVERY_CMDS=8
# Dual-lane CLI timeouts (light = shared SSH; heavy = interface/route/MAC etc.):
# READ = per-command wait; RUN_TIMEOUT_CAP = whole-lane wall clock (often the ~40min abort).
# Light lane reuses NE collect defaults below (read 120s / cap 600s ≈ 10min).
# NETX_NE_COLLECT_READ_TIMEOUT_SEC=120
# NETX_NE_COLLECT_RUN_TIMEOUT_CAP_SEC=600
# Heavy lane defaults (raise CAP if batches end around 40min as partial/timeout):
# NETX_BIZ_STATE_HEAVY_READ_TIMEOUT_SEC=1500
# NETX_BIZ_STATE_HEAVY_RUN_TIMEOUT_CAP_SEC=2400
# NETX_BIZ_STATE_HEAVY_WORKERS=4
# --- Multi-user shared-server capacity (defaults in Settings already match these) --- # --- Multi-user shared-server capacity (defaults in Settings already match these) ---
# NETX_DB_POOL_SIZE=40 # NETX_DB_POOL_SIZE=40
# NETX_DB_MAX_OVERFLOW=40 # NETX_DB_MAX_OVERFLOW=40

5
web/WEB.md
View file

@ -135,6 +135,11 @@ src/
- API 补充：`GET /v1/biz-state/compare/metrics`；模板 `metrics[]` 多表结构 - API 补充：`GET /v1/biz-state/compare/metrics`；模板 `metrics[]` 多表结构
- Phase3：VRF 发现（`*.vrf_list`）供带参采集绑定；`PUT …/items/{id}/bindings` - Phase3：VRF 发现（`*.vrf_list`）供带参采集绑定；`PUT …/items/{id}/bindings`
- 调度：`NETX_BIZ_STATE_SCHEDULER_ENABLED`（默认开），tick `NETX_BIZ_STATE_SCHEDULER_TICK_SEC` - 调度：`NETX_BIZ_STATE_SCHEDULER_ENABLED`（默认开），tick `NETX_BIZ_STATE_SCHEDULER_TICK_SEC`
- **双车道采集**：监控项 `collect_lane=light|heavy`（UI「采集车道」列）。轻/重各一条 SSH；整轮墙钟上限 = `RUN_TIMEOUT_CAP`（命令多时易顶满）。
- 轻车道：`NETX_NE_COLLECT_READ_TIMEOUT_SEC`（单条，默认 120）· `NETX_NE_COLLECT_RUN_TIMEOUT_CAP_SEC`（整轮，默认 **600≈10min**）
- 重车道：`NETX_BIZ_STATE_HEAVY_READ_TIMEOUT_SEC`（单条，默认 1500）· `NETX_BIZ_STATE_HEAVY_RUN_TIMEOUT_CAP_SEC`（整轮，默认 **2400≈40min**）
- 批次约 40 分钟以 `*_timeout (2400s)` / `partial` 结束时，优先加大 `NETX_BIZ_STATE_HEAVY_RUN_TIMEOUT_CAP_SEC`（见 `.env.example`）
- 停止采集：`POST /v1/biz-state/tasks/{id}/collect/stop`（排队直接取消；执行中命令间隙中止）
- 前端：`/network/tasks/biz-state`（勾选监控项 / 发现 VRF / 批次 / 导出 zip） - 前端：`/network/tasks/biz-state`（勾选监控项 / 发现 VRF / 批次 / 导出 zip）
## 拓扑管理（Fabric + 站点目录，对齐厂商） ## 拓扑管理（Fabric + 站点目录，对齐厂商）