模型映射
通过 ONE 强大的数据处理流程,将数据转换成 ONE 的标准数据模型。
模型映射组件
ONE 支持提供了指标映射组建、日志映射组件、调用链映射组件、事件映射组件。通过指定字段匹配的方式将数据转换成 ONE 的协议字段。 关于 ONE 的模型定义参考模型定义章节。

开始使用
指标映射 V2(推荐)
当需要将外部数据集成到 ONE 中时,可以使用指标映射 V2整理指标名称、指标值、时间、类型、维度和标签,使处理后的数据符合指标入库要求。
新建指标映射时,建议优先使用指标映射 V2。该组件将指标字段、维度和标签集中配置,并支持在发布前预览映射结果。
选择指标接入方式
先根据指标是否已经存在于 ONE 中选择接入方式,避免重复创建指标或错误关联已有指标。
| 接入方式 | 适用情况 |
|---|---|
| 动态注册指标 | 根据采集数据中的内容注册指标,若当前分支中配置过CMDB提取,则自动关联对应实例 |
| 映射体系指标 | 将采集到的指标关联到 ONE 中已有的指标 |

配置动态注册指标
当指标名称和指标值需要直接从采集数据中读取时,选择动态注册指标,再按照来源数据的实际结构选择指标名称格式。
指标名称格式支持以下两种配置:
| 格式 | 配置方法 |
|---|---|
| 指标名称和指标值分别为两个字段 | 分别选择保存指标名称和指标值的来源字段 |
| K:V分别描述指标名称和指标值 | 选择一个保存 K:V 内容的来源字段;选择后,单独的指标值字段会隐藏 |
继续填写指标的基本字段:
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 指标名称 | 是 | 选择数据中保存指标名称的字段。使用 K:V 格式时,在这里选择指标名称对应的字段 |
| 指标值 | 是 | 选择保存实际指标值的字段。使用 K:V 格式时不需要单独选择 |
| 指标值发生时间 | 是 | 选择指标值实际发生时间所在的字段,只支持毫秒时间戳 |
| 上报单位 | 否 | 选择数据中的单位字段;如果存在指标单位字段,则必须映射成 ONE 支持的单位 |
| 指标类型 | 是 | 将来源数据中的类型映射为 ONE 支持的指标类型 |
指标类型必须与 ONE 中的指标类型对应。如果类型无法正确映射,数据将不能正常入库。

将来源指标映射到体系指标
当指标已经在 ONE 中创建时,选择映射体系指标,把来源指标逐一关联到体系指标。
- 选择数据中的指标名称、指标值和指标值发生时间字段。
- 点击添加映射,页面新增一行待配置的指标映射。
- 在数据中的指标名称中填写来源数据里的指标名称。
- 在体系中的指标名称中选择要关联的 ONE 指标。
- 完成指标选择后,如需补充维度,点击维度映射。
- 重复以上操作,继续添加其他指标。
选择体系指标时,可以按指标名称、指标 ID、指标分类或标签搜索,也可以先在左侧选择指标分类,再从右侧结果中选择指标。
页面还提供导入指标、导出指标、导入维度、导出维度和创建指标操作。

补充指标维度
指标字段配置完成后,可以补充实体维度和独立维度,用于从不同角度查看和分析指标数据。
实体维度来自关联的实体实例。通过 CMDB 提取或 CMDB 动态注册组件得到的实体实例,可以作为指标的实体维度。
与实体没有直接关系,但需要用于指标分析的字段,可以配置为独立维度:
- 点击添加维度,页面新增一行维度配置。
- 选择数据中的字段。
- 填写或确认维度 ID。
- 在维度配置中选择维度或批量维度。
- 填写维度名称。
- 如果来源字段值需要转换,使用该行中的枚举映射。
页面默认提供 dataCenterId 维度。如果没有为它选择来源字段,系统会使用当前任务所属的数据中心。
添加指标标签
维度配置完成后,可以继续添加标签,用于后续查询和区分指标数据。
系统会读取关联实体实例上的标签,并将这些标签带到指标数据中。如需添加独立标签:
- 点击添加标签,打开来源字段选择窗口。
- 搜索并选择数据中的来源字段。
- 点击确定,页面新增一行标签配置。
- 在新增行中填写标签 Key。
- 如果不再需要该标签,在操作列中删除。
在映射体系指标方式下,独立标签对预置指标不生效。
指标映射
指标映射组件提供了3种映射方案,可以映射指标的基本信息、维度、标签等信息。
-
集成指标扩展:将外部指标快速集成到 ONE 中进行数据分析,该方式集成的指标可以在仪表盘和数据探索模块中查看。

-
动态指标注册(关联CMDB):将外部指标快速集成到 ONE 的同时,会将前置流程中提取的CMDB实例关联到指标的实体维度上,后续可根据实体关联更多分析维度,该方式集成的指标可以在仪表盘和数据探索模块中查看。

-
映射体系指标(关联CMDB):将外部指标与 ONE 体系中的指标进行一一匹配映射,体系指标是 ONE 经过行业实践沉淀的标准指标,在产品的多个模块中被深度使用。

日志映射
日志映射组件可以配置日志的基本信息映射和属性映射。

事件映射
事件映射组件将外部事件和告警数据转化成 ONE 的标准事件模型数据。支持配置事件的类型、等级、状态、发生和结束时间以及事件原始信息等基本信息,还可以对事件设置标签和属性,丰富平台对事件的分析能力。

告警映射
当 Prometheus、Zabbix、云平台或其他第三方系统上报告警时,可以使用告警映射统一告警状态、等级、数据来源、资源域和标签,使数据符合 ONE 的告警模型。
配置告警基本字段
先将来源数据中的字段对应到 ONE 的告警属性,确保告警具备名称、状态、等级和来源等基本信息。
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 告警状态 | 是 | 选择来源数据中保存告警状态的字段,并通过枚举映射统一状态值 |
| 告警名称 | 是 | 选择保存告警名称的来源字段 |
| 告警等级 | 是 | 选择保存告警等级的来源字段,并通过枚举映射统一等级 |
| 告警数据来源 | 是 | 选择用于说明告警来源系统的字段,并通过枚举映射统一来源名称 |
| 所属资源域 | 是 | 选择来源数据中的资源域字段,并将字段值映射到当前 ONE 环境已有的资源域 |
| 唯一性约束 | 是 | 选择数据中的一个或多个字段,作为告警唯一性判断的依据;至多选五个字段作为唯一性约束 |

统一告警枚举值
来源系统对状态、等级和数据来源的写法可能不同,可以使用枚举映射将这些值转换成 ONE 使用的值。
- 先选择对应的来源字段。
- 点击字段右侧的枚举映射。
- 在每个 ONE 枚举值后填写对应的来源数据值。
- 如果多个来源值表示同一个结果,按照输入框提示使用分号隔开。
- 点击保存完成映射。
未选择来源字段时,枚举映射按钮不可用。
映射告警状态
告警状态支持以下目标值:
| 目标状态 | 说明 |
|---|---|
| 告警中 | 表示告警仍在持续 |
| 已恢复 | 表示告警已经恢复 |
| 已关闭 | 表示告警已经关闭 |
配置状态枚举时,还需要根据页面提示关联相应的时间字段:
- 告警中:可以关联告警发生时间和告警更新时间。
- 已恢复:关联告警恢复时间。
- 已关闭:关联告警关闭时间。
- 页面中带
*的时间字段为必填项。

映射告警等级
ONE 的告警等级包括:
| 告警等级 |
|---|
| 提醒 |
| 一般 |
| 警告 |
| 严重 |
| 致命 |
例如,来源系统中的 warning、WARN 或其他同义值,可以根据实际含义填写到对应等级中。
映射告警数据来源
ONE 支持将来源值映射为以下类型:
- Prometheus
- Zabbix
- 阿里云
- 华为云
- 天翼云
- 腾讯云
- 第三方
如果实际来源不属于页面列出的具体平台,可以根据业务情况映射为第三方。
映射所属资源域
所属资源域的枚举列表来自当前 ONE 环境。将来源数据中的资源域值填写到对应资源域后,告警数据会使用映射后的资源域。
不同环境中配置的资源域可能不同,请以枚举映射窗口实际显示的资源域为准。
关联告警实体
完成基本字段后,确认告警是否包含实体关联信息,便于后续从告警定位到对应资源。
告警映射组件会根据数据中的 _CMDB 字段自动完成实体关联,不需要在当前组件中再次选择实体。
如果需要让告警关联到实体,应先在前置处理流程中生成正确的 _CMDB 字段。
设置唯一性约束
唯一性约束用于为告警提供唯一性判断依据。
- 在唯一性约束中选择数据里的一个字段。
- 确认该字段能够区分不同告警。
- 使用预览结果检查该字段是否已经正常输出。
添加告警标签
如果还需要使用来源数据中的其他字段筛选或区分告警,可以将这些字段配置为标签。
- 点击添加标签,页面新增一行标签配置。
- 在数据中的字段中选择来源字段。
- 在 Label Key 中填写该标签在 ONE 中使用的名称。
- 如果不再需要该标签,点击该行的删除。
- 需要添加其他标签时,继续点击添加标签。
验证
点击执行预览,在数据预览面板中查看,执行预览状态下是对数据处理的模拟,平台中不会产生真实数据。