MBean
MBean(Managed Bean)是通过 JMX 暴露的可管理 Java 对象。MBean 采集规则可以将选定的 JMX 属性转化为指标。目标 Java 进程需安装应用探针,且 Java Agent 版本不低于 9.8.0;导入文件时不会校验 Agent 版本。
创建采集规则
通过创建规则,为服务或进程组采集所需的 MBean 属性。
-
进入 部署配置 → 规则配置 → 数据采集 → MBean,点击 创建。

-
通过服务、服务标签、进程组或进程组标签设置生效范围。在该范围内选择一个进程,点击 更新 MBean 加载其可用的 MBean。
-
点击 添加指标,选择域、过滤 JMX MBeans Keys、MBean、属性和属性 Keys,配置指标模型并保存。规则会出现在列表中。

导出规则以便复用
当需要在其他环境中复用时,可将已配置的规则导出。
点击搜索框右侧的 导出 图标。导出的 Excel 文件包含所有自定义 MBean 规则(不受当前搜索筛选条件影响),其列结构与导入模板一致。
从 Excel 导入规则
通过导入已导出的文件或填写模板,可以在目标环境中批量创建规则,无需手动选择进程或刷新 MBean。
-
点击 创建 旁边的 导入,在弹窗中点击 下载模板;也可使用从其他环境导出的规则文件。

-
按模板第 2 行的说明填写,并替换或删除第 3 行的示例规则。每行是一条规则,填写 描述、启用、条件关系、生效范围 和 指标配置 五列。后两列填写 JSON 数组,JSON key 使用英文;启用、条件关系 及 JSON 中的枚举值使用模板编码。同一规则的多个指标写在该行的 指标配置 数组中。

-
选择或拖入一个
.xlsx或.xls文件:大小不超过 10 MB,规则条数不超过 100 条。文件中引用的服务、进程组或标签名称必须在目标环境中已存在。 -
等待系统校验。校验通过后点击 确定,新规则会出现在列表中。校验失败时,文件下方会显示首个错误的行号和原因,确定 不可点击;修正文件后点击 重新上传。只有整个文件校验通过后,规则才会被导入。
导入只新增规则;描述或指标 ID 与目标环境重复时,整份文件会校验失败。
确认指标采集结果
在规则列表确认规则已出现。若需开始采集,检查页面顶部的 自定义配置 MBean 和该规则的 启用 开关,再到指标页面的 系统服务 → 服务实例 → JMX 分类下查找指标,并在仪表盘中分析或配置告警。
