跳到主要内容

模型映射

通过 ONE 强大的数据处理流程,将数据转换成 ONE 的标准数据模型。

模型映射组件​

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

modelMap

开始使用​

指标映射 V2(推荐)​

信息

当需要将外部数据集成到 ONE 中时,可以使用指标映射 V2整理指标名称、指标值、时间、类型、维度和标签,使处理后的数据符合指标入库要求。

推荐方式

新建指标映射时,建议优先使用指标映射 V2。该组件将指标字段、维度和标签集中配置,并支持在发布前预览映射结果。

选择指标接入方式​

先根据指标是否已经存在于 ONE 中选择接入方式,避免重复创建指标或错误关联已有指标。

接入方式适用情况
动态注册指标根据采集数据中的内容注册指标,若当前分支中配置过CMDB提取,则自动关联对应实例
映射体系指标将采集到的指标关联到 ONE 中已有的指标

映射方式选择

配置动态注册指标​

当指标名称和指标值需要直接从采集数据中读取时,选择动态注册指标,再按照来源数据的实际结构选择指标名称格式。

指标名称格式支持以下两种配置:

格式配置方法
指标名称和指标值分别为两个字段分别选择保存指标名称和指标值的来源字段
K:V分别描述指标名称和指标值选择一个保存 K:V 内容的来源字段;选择后,单独的指标值字段会隐藏

继续填写指标的基本字段:

字段是否必填说明
指标名称是选择数据中保存指标名称的字段。使用 K:V 格式时,在这里选择指标名称对应的字段
指标值是选择保存实际指标值的字段。使用 K:V 格式时不需要单独选择
指标值发生时间是选择指标值实际发生时间所在的字段,只支持毫秒时间戳
上报单位否选择数据中的单位字段;如果存在指标单位字段,则必须映射成 ONE 支持的单位
指标类型是将来源数据中的类型映射为 ONE 支持的指标类型
注意

指标类型必须与 ONE 中的指标类型对应。如果类型无法正确映射,数据将不能正常入库。

动态注册指标字段配置

将来源指标映射到体系指标​

当指标已经在 ONE 中创建时,选择映射体系指标,把来源指标逐一关联到体系指标。

  1. 选择数据中的指标名称、指标值和指标值发生时间字段。
  2. 点击添加映射,页面新增一行待配置的指标映射。
  3. 在数据中的指标名称中填写来源数据里的指标名称。
  4. 在体系中的指标名称中选择要关联的 ONE 指标。
  5. 完成指标选择后,如需补充维度,点击维度映射。
  6. 重复以上操作,继续添加其他指标。

选择体系指标时,可以按指标名称、指标 ID、指标分类或标签搜索,也可以先在左侧选择指标分类,再从右侧结果中选择指标。

页面还提供导入指标、导出指标、导入维度、导出维度和创建指标操作。

体系指标映射及指标选择面板

补充指标维度​

指标字段配置完成后,可以补充实体维度和独立维度,用于从不同角度查看和分析指标数据。

实体维度来自关联的实体实例。通过 CMDB 提取或 CMDB 动态注册组件得到的实体实例,可以作为指标的实体维度。

与实体没有直接关系,但需要用于指标分析的字段,可以配置为独立维度:

  1. 点击添加维度,页面新增一行维度配置。
  2. 选择数据中的字段。
  3. 填写或确认维度 ID。
  4. 在维度配置中选择维度或批量维度。
  5. 填写维度名称。
  6. 如果来源字段值需要转换,使用该行中的枚举映射。

页面默认提供 dataCenterId 维度。如果没有为它选择来源字段,系统会使用当前任务所属的数据中心。

添加指标标签​

维度配置完成后,可以继续添加标签,用于后续查询和区分指标数据。

系统会读取关联实体实例上的标签,并将这些标签带到指标数据中。如需添加独立标签:

  1. 点击添加标签,打开来源字段选择窗口。
  2. 搜索并选择数据中的来源字段。
  3. 点击确定,页面新增一行标签配置。
  4. 在新增行中填写标签 Key。
  5. 如果不再需要该标签,在操作列中删除。
注意

在映射体系指标方式下,独立标签对预置指标不生效。

指标映射​

指标映射组件提供了3种映射方案,可以映射指标的基本信息、维度、标签等信息。

  • 集成指标扩展:将外部指标快速集成到 ONE 中进行数据分析,该方式集成的指标可以在仪表盘和数据探索模块中查看。

    MetricMapTypeNoCMDB

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

    MetricMapTypeCMDB

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

    MetricMapTypeSystem

日志映射​

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

logMap

事件映射​

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

eventMap

告警映射​

信息

当 Prometheus、Zabbix、云平台或其他第三方系统上报告警时,可以使用告警映射统一告警状态、等级、数据来源、资源域和标签,使数据符合 ONE 的告警模型。

配置告警基本字段​

先将来源数据中的字段对应到 ONE 的告警属性,确保告警具备名称、状态、等级和来源等基本信息。

字段是否必填说明
告警状态是选择来源数据中保存告警状态的字段,并通过枚举映射统一状态值
告警名称是选择保存告警名称的来源字段
告警等级是选择保存告警等级的来源字段,并通过枚举映射统一等级
告警数据来源是选择用于说明告警来源系统的字段,并通过枚举映射统一来源名称
所属资源域是选择来源数据中的资源域字段,并将字段值映射到当前 ONE 环境已有的资源域
唯一性约束是选择数据中的一个或多个字段,作为告警唯一性判断的依据;至多选五个字段作为唯一性约束

alert-map-basic-fields

统一告警枚举值​

来源系统对状态、等级和数据来源的写法可能不同,可以使用枚举映射将这些值转换成 ONE 使用的值。

  1. 先选择对应的来源字段。
  2. 点击字段右侧的枚举映射。
  3. 在每个 ONE 枚举值后填写对应的来源数据值。
  4. 如果多个来源值表示同一个结果,按照输入框提示使用分号隔开。
  5. 点击保存完成映射。

未选择来源字段时,枚举映射按钮不可用。

映射告警状态​

告警状态支持以下目标值:

目标状态说明
告警中表示告警仍在持续
已恢复表示告警已经恢复
已关闭表示告警已经关闭

配置状态枚举时,还需要根据页面提示关联相应的时间字段:

  • 告警中:可以关联告警发生时间和告警更新时间。
  • 已恢复:关联告警恢复时间。
  • 已关闭:关联告警关闭时间。
  • 页面中带 * 的时间字段为必填项。

alert-map-status-enum

映射告警等级​

ONE 的告警等级包括:

告警等级
提醒
一般
警告
严重
致命

例如,来源系统中的 warning、WARN 或其他同义值,可以根据实际含义填写到对应等级中。

映射告警数据来源​

ONE 支持将来源值映射为以下类型:

  • Prometheus
  • Zabbix
  • 阿里云
  • 华为云
  • 天翼云
  • 腾讯云
  • 第三方

如果实际来源不属于页面列出的具体平台,可以根据业务情况映射为第三方。

映射所属资源域​

所属资源域的枚举列表来自当前 ONE 环境。将来源数据中的资源域值填写到对应资源域后,告警数据会使用映射后的资源域。

信息

不同环境中配置的资源域可能不同,请以枚举映射窗口实际显示的资源域为准。

关联告警实体​

完成基本字段后,确认告警是否包含实体关联信息,便于后续从告警定位到对应资源。

告警映射组件会根据数据中的 _CMDB 字段自动完成实体关联,不需要在当前组件中再次选择实体。

如果需要让告警关联到实体,应先在前置处理流程中生成正确的 _CMDB 字段。

设置唯一性约束​

唯一性约束用于为告警提供唯一性判断依据。

  1. 在唯一性约束中选择数据里的一个字段。
  2. 确认该字段能够区分不同告警。
  3. 使用预览结果检查该字段是否已经正常输出。

添加告警标签​

如果还需要使用来源数据中的其他字段筛选或区分告警,可以将这些字段配置为标签。

  1. 点击添加标签,页面新增一行标签配置。
  2. 在数据中的字段中选择来源字段。
  3. 在 Label Key 中填写该标签在 ONE 中使用的名称。
  4. 如果不再需要该标签,点击该行的删除。
  5. 需要添加其他标签时,继续点击添加标签。

验证​

点击执行预览,在数据预览面板中查看,执行预览状态下是对数据处理的模拟,平台中不会产生真实数据。