Web界面内存占用率显示问题分析（S920X20 + openUBMC 2509）

根据您提供的详细信息，当前问题为：在S920X20硬件平台、openUBMC 25.09.01.07固件版本下，Web界面的“内存占用率”无法正常显示（显示为--），但其他服务器（如920s/920l）在同一固件版本下显示正常，且IBMA通讯正常。

以下是基于知识图谱和文档资料的系统性分析与解决方案建议。

问题定位：Web界面内存占用率未显示

根本原因分析

1. 内存占用率依赖BMA Agent数据上报

从知识库中的文档块 [3]（CSR配置字典之MemoryMetrics类）和KG实体 BandwidthPercent 可知：

• 内存占用率（BandwidthPercent）默认值为255，表示无效或未初始化状态。
• Web界面的“内存占用率”显示依赖于 BMA Agent（Host Agent） 向BMC上报的 MemUsage 数据。
• 在KG关系中明确指出：Memory Information 与 Web Interface 存在 “未显示” 的关系，说明存在数据链路中断风险。

文档支持：

“内存占用率：您必须先在服务器OS侧安装BMA 2.0，并完全启动后，方可查看内存占用率信息。” —— Document Chunk 3

尽管用户未提及是否安装BMA，但IBMA通信正常，初步推断 BMA服务已在OS侧运行并建立连接。然而，仍可能存在 数据未正确传递或解析 的情况。

2. Host Agent 接口未正确返回内存使用率

KG文档中提及关键调试方式：

busctl --user introspect bmc.kepler.host_agent /bmc/kepler/Systems/1/Sms/1/ComputerSystem/Systems/1/Summary | cat

应检查以下属性是否存在且有有效值：

• MemUsage：内存使用率（百分比）
• TotalSystemMemoryGiB：总内存容量
• SystemMemoryBuffersGiB / SystemMemoryCachedGiB：缓存信息

如果 MemUsage 无值或为 0，则说明 Host Agent 未正确采集或上报数据。

3. S920X20 特定配置或兼容性问题

虽然同为920系列，但 920L为自制板（非标准S920X20），可能存在以下差异：

KG中提到：

“openUBMC2509…在生产部署中表现出异常日志模式、告警报告不一致、磁盘事件日志异常等问题。”
—— Entity OpenUBMC2509 描述

即使在标准S920X20上运行稳定，在自制板上仍可能暴露边缘缺陷。

4. 资源协作接口状态异常

从KG文档 5 中可查：

• Host Agent 通过 bmc.kepler.Systems.Sms 提供资源协作接口。
• 需验证两个关键点：
  1. Registered 是否为 true
  2. State 是否为 0

可通过以下命令检查：

# 查看注册状态
busctl --user get-property bmc.kepler.Systems.Sms /bmc/kepler/Systems/1/Sms bmc.kepler.Systems.Sms Registered

# 查看状态
busctl --user get-property bmc.kepler.Systems.Sms /bmc/kepler/Systems/1/Sms bmc.kepler.Systems.Sms Status

若 Registered=false 或 State≠0，则 Host Agent 服务未完全准备就绪，导致内存数据无法同步。

排查步骤建议

步骤一：确认 Host Agent 是否正常注册

ssh root@192.168.133.250

# 检查注册状态
busctl --user get-property bmc.kepler.Systems.Sms /bmc/kepler/Systems/1/Sms bmc.kepler.Systems.Sms Registered

# 检查运行状态
busctl --user get-property bmc.kepler.Systems.Sms /bmc/kepler/Systems/1/Sms bmc.kepler.Systems.Sms Status

期望输出：

• Registered: true
• Status: 0

步骤二：检查 Host Agent 上报的内存数据

busctl --user introspect \
  bmc.kepler.host_agent \
  /bmc/kepler/Systems/1/Sms/1/ComputerSystem/Systems/1/Summary

重点关注输出中是否包含：

"MemUsage": "65",
"TotalSystemMemoryGiB": "64.0"

若无 MemUsage 字段或值为 0 或 255 → 上报失败。

步骤三：一键收集日志分析 host_agent

# 执行一键收集
# 在Web界面：维护诊断 → 一键收集

# 或 SSH 下执行
bmc_collect.sh -t all -o /tmp/dump_info

# 查看 host_agent 日志
cat /tmp/dump_info/AppDump/host_agent/mdb_info.log | grep -i memusage

若日志中无 MemUsage 上报 → 问题出在 OS 端 Host Agent。

步骤四：确认 OS 端 BMA Agent 状态

登录服务器操作系统，检查：

# 检查服务状态
systemctl status ibma

# 查看日志
journalctl -u ibma | grep -i memory

# 确认进程存在
ps aux | grep ibma

若服务未启动或频繁重启 → 需排查驱动兼容性、签名问题或依赖缺失。

步骤五：对比其他正常机器的 CSR 配置

检查 MemoryMetrics 类配置是否一致：

{
  "MemoryMetrics": {
    "BandwidthPercent": 65,
    "BandwidthThresholdPercent": 85
  }
}

可通过以下路径检查：

/etc/kepler/configure/csr/

若该配置项缺失或 BandwidthPercent 为 255，则 Web 前端会显示为空。

解决方案建议

方案1：重启 Host Agent 服务

systemctl restart ibma
# 观察 Web 界面是否恢复

方案2：强制重载 CSR 配置

# 重启 metrics 服务
systemctl restart bmc.kepler.metrics.service

# 或触发 CSR 重载
bmc_csr_reload.sh

方案3：重新部署适配920L的 VPD/FRU 配置

• 确保自制板的 VPD 文件已正确烧录。
• 检查 manifest.yml 中 board_name 是否已设为 S920X20 或 920L。
• 若使用社区通用SR，需根据实际硬件修改内存通道、BOM ID等字段（参考文档 [7]）。

方案4：升级至已知稳定版本（如 openUBMC2512）

虽然您当前使用2509版本，但可考虑升级至 OpenUBMC2512 或更高版本：

KG说明：

• OpenUBMC2512 被识别为用于 S920X20 的更新软件版本。
• 更高版本通常修复了低版本中关于 内存占用率不显示 的UI渲染问题。

总结

原因	概率	推荐动作
BMA未上报 MemUsage	☆	检查 OS 端服务与日志
Host Agent 未注册		检查 Registered 状态
CSR 配置缺失或默认值为255		检查 MemoryMetrics 配置
自制板 VPD/FRU 不兼容		更新板级配置文件
openUBMC 2509 特定缺陷		升级至 2512 或 LTS 版本

参考文档

• CSR 配置字典之 MemoryMetrics 类
• 资源协作接口文档
• openUBMC 在线调试特性说明
• 鲲鹏模组适配约束FAQ

建议优先执行 busctl 探针命令，最快定位是 数据层缺失 还是 前端渲染问题。

如有进一步日志输出，欢迎提供以深入分析。

相关链接：

1. 2512版本内存占用率不显示
2. 【BMC Studio】BMC Studio新特性介绍：基于Qemu进行代码调试与资源协作接口调试
3. 【iTestSmart】BMC启动后处于静默状态，CPU占用率测试，测试结果Fail。
4. BMC 无法正常显示内存占用率信息
5. openUBMC 182x大板管理特性设计说明书 | 文档中心 | openUBMC