配置项说明 ​

配置原则说明 ​

1. UBS VirtAgent的配置能力通过文件的方式暴露。

2. UBS VirtAgent配置文件采用ini文件格式：

   • 由键（key）和值（value）构成。

   • 配置文件包含多个键值对。

   • 每个键值对用等号（=）进行连接；左边为键，作为配置项的名称；右边为值，作为配置项内容。

3. 配置项设计，各节点配置独立。

4. 配置后需要重启节点UBS Engine进程（UBS VirtAgent属于UBS Engine的插件，在同一进程内）。

UBS VirtAgent配置文件样例如下：

# Name of the virt_agent plugin. Fixed value: virt_agent.
ubse.plugin.name=virt_agent
# Name of the SO file on which the virt_agent module depends. Fixed value: libvirtagent.so.
ubse.plugin.pkg=libvirtagent.so
# Collection period of the VM module, in seconds. The value range is [1, 60].Any invalid value will be reset to 2.
ubse.plugin.vm.export.interval=2

# Decision configuration item
# Second escape watermark of the decision-making module. A value greater than the second escape watermark will trigger memory borrowing. The value range is [70, 95](and borrow.watermark >= high.watermark + 5).Any invalid value will be reset to 92.
borrow.watermark=92
# High and low watermark percentage configuration with a value range of [0, 100]. A high watermark triggers borrowing or migration, and a low watermark triggers returning. The value is configured to the memory subsystem and used for decision-making modules.
# [Only for virtualization scenario] High watermark percentage configuration with a value range of [65, 90](and high.watermark >= low.watermark + 5)
# [Only for virtualization scenario] Low watermark percentage configuration with a value range of [60, 80]
high.watermark=85
low.watermark=80

配置详细说明 ​

配置项说明

内存开销估算与 MemoryMax 配置 ​

UBSE 以 systemd 服务（ubse.service）运行，进程内存上限由 unit 中的 MemoryMax 控制（默认 256M，见 /usr/lib/systemd/system/ubse.service）。UBS VirtAgent 作为 UBSE 的插件在同一进程内运行，其内存开销随纳管 Pod 数、活跃 borrowId 数、虚机迁出容量和超分虚机数变化；baseline 随集群节点数增长，不宜直接套用其他环境的固定值，应按式估算或在目标节点空跑实测。

超出上限的后果：UBSE 进程会被 cgroup 直接杀死（由 Restart=on-failure 重启），内存借用业务随之中断，务必预留余量。

基线占用：未启用插件、空跑 UBSE 时的占用随集群节点数增长，可按 baseline(MB) ≈ 50 + 24 × (n - 1) 估算（n 为集群节点数，cgroup 口径）；也可在目标节点停用插件后直接读取 systemctl show ubse -p MemoryCurrent 核对，进程口径可读 /proc/<pid>/status（VmRSS）或由 /proc/<pid>/smaps_rollup 汇总 PSS。

总占用估算：各场景 UBSE 进程的预计总占用为 占用(MB) ≈ baseline(n) + 场景增量，其中 baseline(n) 为上文估算（或目标节点实测）的空跑 UBSE 占用，场景增量为 3.1~3.3 各节的估算值。判断 MemoryMax 余量时按 baseline(n) + 场景增量 与 MemoryMax 比较（如 3 节点 baseline ≈ 98 MB，加上容器借用场景约 60 MB 后约 158 MB，默认 256M 尚有余量；8 节点 baseline ≈ 218 MB，加上增量后已接近默认值，应提前上调）。各节增量为进程口径估算，cgroup 口径的增量通常略高于该值，据此判断余量时应适当放宽。

口径说明：本章数据均只估算 UBSE 进程自身的内存增量，不包含实际借入/超分出去的内存容量本身；涉及节点总内存的估算均按物理总内存计算，未扣除操作系统、Kubernetes 与业务预留，生产规划应以节点 Allocatable 替代物理总内存。

MemoryMax 调整：修改 /usr/lib/systemd/system/ubse.service 中的 MemoryMax（建议用 systemctl edit ubse 创建 drop-in，避免升级时被覆盖），执行 systemctl daemon-reload && systemctl restart ubse 生效。

容器借用场景 ​

容器借用场景下，稳态增量上界按下式估算：

• 最大活跃 borrowId 数：N_borrow ≈ min(物理机内存 × 25% 借用上限 ÷ 单块最小借用 4 GB, MAX_BORROW_ID_COUNT)
• UBSE 内存增量：RSS 增量 ≈ B × N_borrow

结论：物理机内存约 2860 GB 时，容量推导值约 179 个，受 MAX_BORROW_ID_COUNT=100 约束后最大活跃 borrowId 数为 100 个，可借入容量上限约 100 × 4 GB = 400 GB，对应 UBSE 内存上涨约 60 MB（B × N_borrow = 0.6 MB/个 × 100）。

虚机碎片场景（碎片迁出） ​

碎片迁出场景：节点上已有一台正常虚机，剩余本地内存不足以再创建一台等大虚机；此时借用远端内存，将第一台虚机 25% 的内存迁出，腾出的本地内存用于创建第二台虚机。稳态增量与迁出容量按下式估算：

• 节点最大可迁出内存：M_max ≈ (节点总内存 ÷ 2) × 25%（第一台虚机迁出自身 25% 内存，本例按两台虚机等大计算）
• UBSE 内存增量：RSS 增量 ≈ K × M_max ÷ 2 GB

结论：节点总内存约 2860 GB 时，最多可迁出约 357 GB，按最大情况系数 K≈4 估算 UBSE 内存上涨约 715 MB（平均情况 K≈2 时约 360 MB）。

虚机超分场景 ​

增量与虚机数量按下式估算：

• 可创建虚机数量：N_max ≈ min(节点总内存 ÷ 单虚机规格, MAX_VM_NUM)
• UBSE 内存增量：RSS 增量 ≈ C × N_vm

结论：节点总内存约 2860 GB 时，容量推导值约 357 个，受 MAX_VM_NUM=300 约束后最大虚机数为 300 个，按最大情况系数 10 MB/个估算，UBSE 内存上涨约 3000 MB（≈ 3 GB）。

MemoryMax 配置建议 ​

按上述估算式，各场景 UBSE 进程增量上界汇总如下（规划时按实际部署的场景与规模取值）：

• 表内增量为各场景上界，判断余量应按 baseline(n) + 增量 与 MemoryMax 比较（baseline(n) 见本章开头的「基线占用」，如 3 节点约 98 MB、8 节点约 218 MB）；调整方法与超限后果见本章开头的「MemoryMax 调整」。