指标定义

在指标定义页面可以查看系统中的指标，可以新建指标，支持原子、派生和计算指标。

创建原子指标

1）在指标定义页面中，点击新建指标按钮，并选择原子指标

2）点击后进入原子指标的定义页面，包含基本信息、计算信息、时间信息、指标目录和加速查询（后文统一介绍）的配置

3.png

  • 基本信息：指标名称、指标标识、负责人、业务口径和指标描述

  • 计算信息

    • 选择该指标的依赖模型

    • 选择模型中的一个度量字段

    • 设置该字段的计算逻辑（指标的聚合方式，包含 SUM、COUNT 等选择）和数据格式（指标结果的展示格式）

    • 选择该原子指标的分析「维度」

    • 对指标数据和时间进行筛选

确定「度量」和「维度」之后，右侧所见即所得看到该原子指标在所选第一个分析维度下的数据分布：

11.png

  • 时间信息：只有选择时间维度才可配置时间信息，选择时间粒度后可设置同环比，指标的同环比数据会在指标详情页展示

22.png

  • 指标目录：选择该指标所属的指标目录

创建派生指标

1）在指标定义页面中，点击新建指标按钮，并选择派生指标。

2）进入指标的定义页面，包含基本信息、计算信息、时间信息、指标目录和加速查询（后文统一介绍）的配置，「基本信息」和「指标目录」的设置与原子指标相同，不再赘述

3）定义这个派生指标的计算信息：

  • 依赖指标：可以选择已发布的基础指标

  • 数据格式：指定指标结果的展示格式

  • 维度：从依赖的指标的维度范围中选择

  • 数据筛选：该指标的数据、维度筛选或指定时间周期/动态时间

  • 加速查询（后文统一介绍）

  • 确定「依赖指标」和「维度」之后，右侧所见即所得看到该派生指标在所选第一个分析维度下的数据分布

创建计算指标

1）在指标定义页面中，点击新建指标按钮，并选择计算指标。

2）点击后，进入指标的定义页面，包含基本信息、计算信息、时间信息、指标目录和加速查询（后文统一介绍）的配置，「基本信息」和「指标目录」的设置与原子指标相同，不再赘述。

3）在计算信息部分

  • 配置表达式：提供丰富的表达式，支持快速插入模型的度量、维度字段及已有指标，通过变量之间的灵活计算得到「计算指标」

  • 数据格式：指定指标结果的展示格式

  • 维度：从依赖的指标的维度范围中选择

  • 数据筛选：对维度、数据、时间进行筛选

  • 配置完「表达式」，确定「维度」之后，右侧所见即所得看到该计算指标在所选第一个分析维度下的数据分布

指标加速

为了让指标的查询速度更快，用户可以通过「打开加速查询」，开启后系统将自动为该指标创建物化视图，从而提升指标的查询性能：

开启加速查询后，用户可进行加速配置，包括报警执行计划和告警信息的配置

执行计划

  • 调度类型：用户可以选择单次调度，或者周期调度。若选择周期调度，用户还需要选择周期调度的频率和执行时间。

  • 出错重试：若任务失败，可指定重试次数。

告警信息

在告警信息中，用户可以选择是否开启告警

  • 触发规则：可选择在「运行开始」、「运行失败」、「运行完成」三种状态下告警

  • 接收人：负责人或指定用户或报警组

  • 接收方式：邮件或电话或POPO

创建来源于指标系统的指标

对于同时购买了指标系统+指标平台的客户，为了把「指标系统」中已录入的指标在「指标平台」侧快速开发上线，且指标信息能够全流程一致。我们提供了在指标平台一键创建「来源指标系统的指标」功能。

当用户在指标平台创建指标时，选中指标类型进入指标开发页面后，可以选择「来源指标系统的指标」，点击后呼出指标的选择框，可选相同项目组指标系统的指标（为了保证指标的唯一性，禁选与指标平台现有指标重名的指标）：

选中系统中指标后，会自动把指标系统中该指标的「基础属性」、「口径定义」、「技术信息」三个模块的已启用内容自动带入（自动带入的内容不允许修改），指标的计算信息、指标域及资源目录则由用户在系统和平台中分别创建目录、分别选择路径，创建完成后，可在指标的「详细信息」中看到该指标的所有属性：

其他说明：若在平台开发了一个来源于系统的指标，那么该指标提需人（即指标系统中的指标创建人）默认有该指标在指标平台的分析权限；

同时对于上述在「指标平台」中开发且来源为「指标系统」的指标，在「指标系统」中该指标点击「前往分析」即可一键跳转至指标平台侧分析指标数据： 对于在「指标平台」开发的指标，指标系统侧「申请发布」时（如下图红框流程），检测指标是否已经在平台开发完成并上线，若已上线，则允许点击「申请发布」：

批量创建来源于指标系统的指标

为了提高创建来源于指标系统指标的效率，我们新增了批量创建源于指标系统指标的功能，目前支持原子指标和派生指标的批量创建，能够帮助用户一键创建所需的所有指标。在批量创建前，需要在「资源配置」中打开「启用指标系统指标」开关且完成字段映射，才可进行批量创建。

用户在「指标定义」页面可通过点击「批量创建」进入创建流程。成功批量创建原子指标需要历经选择导入指标、模型解析、指标解析三步，创建派生指标三部曲为选择导入指标、依赖指标解析、指标解析，成功解析后方可导入成功。 POPO-20241010-1.png

1）选择导入指标：根据指标目录批量选择需要创建的源于指标系统的指标，不可选择与指标平台当前项目下和指标系统不同集群下重名的指标。 POPO-20241010-2.png

2）模型/依赖指标解析

  • 模型解析：原子指标在这一步会进行数据源和模型解析，如不存在数据源则对应指标直接导入失败，所以用户需要在批量创建前至「配置管理-资源配置」中登记数据源。在模型解析过程中，可以根据指标系统的表新建模型或者选择指标平台当前项目下的可用模型，完成选择后可进入下一步。

POPO-20241011-66.png

  • 依赖指标解析：在派生指标的依赖指标解析过程中，指标平台会自动匹配当前项目下与指标系统中依赖指标同名的指标，如同名指标不存在或不匹配，用户还可自行选择其他指标平台内指标做为依赖指标。若没有合适的指标，可以不选择依赖指标，那么指标创建失败。

111.png

3）指标解析：在这一步会进行指标内容的解析，包括必填项信息是否具备、指标域是否存在等等，并展示所有指标失败的原因。确认无误后可点击「确认创建」，即可创建成功。

POPO-20241011-44.png

批量创建失败可能存在以下原因：

  • 字段无法获取。报错原因是在指标系统中未填写字段名称，可填写后重试。
  • 指标域未创建。在指标平台中没有适配的指标域，可前往「配置管理-指标目录」创建对应的指标域。
  • 库表不存在。新建模型时，指标系统不存在该指标的库和表，会导致指标导入失败。
  • 指标系统xx集群未配置库表名/度量字段。如果集群没有完成库表名/度量字段映射，则创建失败。可至「配置管理-连接指标系统」中进行配置。
  • 未选择依赖指标。在批量创建派生指标的过程中，如果没有权限或无合适依赖指标可能会导致依赖指标不存在，故指标创建失败。

如导入失败，可对照错误原因修改后重试。

资源迁移

为了将测试环境的指标迁移到生产环境中，可以将指标导出成离线文件，再将该离线文件导入至目标项目或环境中。

1）资源批量导出：在「指标定义」页面勾选需要迁移的指标，再点击「资源批量导出」即可导出指标资源包文件。资源批量导出会导出指标的所有信息，包括依赖指标、数据源、模型等各种依赖资源，用户可以选择是否导出指标的调度信息（包括指标的加速和预警设置）。

POPO-20241010-44.png

2）资源批量导入：点击「资源批量导入」上传资源包后会进行模型解析和指标解析，解析成功后即可导入指标。

  • 模型解析：资源包在这一步会进行数据源和模型解析，如果没有适配数据源可以前往「资源配置」中新增数据源。导入模型存在两种情况，一是与当前项目的模型不存在相同名称/标识情况，那么可以正常导入模型；二是与当前项目模型存在相同名称/标识情况，如果字段匹配系统会自动执行跳过（使用当前项目同名模型）或更新（使用导入模型）操作。

POPO-20241010-55.png

  • 指标解析：会解析指标的重名情况，并以指标为粒度展示每个指标的解析成功或失败状态，并附上失败原因。点击「确认导入」即可完成导入。

123.png

解析失败原因如下所示：

  • 数据源：当前项目不存在匹配数据源。如果出现当前数据源问题，说明当前项目不存在该指标的数据源，可以前往「资源配置」中登记数据源。

  • 模型：模型解析失败。如果出现模型解析失败可能会存在以下情况：

    • 权限：无模型操作权限。如果「替换」无「编辑」权限模型，则模型替换失败；如果「跳过」无「查看」权限模型，则模型使用失败。如果无「新建模型」权限，则模型导入失败，这些情况都会导致依赖的指标导入失败。用户可至「安全中心」查看是否拥有对应的模型权限。

    • 模型状态：导入模型状态与相同名称/标识模型状态不匹配。由于重名模型状态相同才能执行跳过或更新操作，所以当出现这种提示时，可以修改模型状态完成导入。

    • 字段匹配失败原因：模型名称/标识相同且字段不匹配。新环境模型字段包含（或等于）导入模型字段，则自动执行模型「跳过」，匹配新环境模型。模型标识相同，且导入模型字段包含新环境模型字段，则自动执行模型「更新」。字段匹配失败可能是由于字段类型或名称不匹配，可至模型详情中查看字段具体信息。

    • 负责人不存在：当前项目不存在该模型负责人。在新环境或新项目中可能不存在导入模型的负责人，可修改或添加负责人后重试。

  • 指标解析失败

    • 指标重名：导入指标或其依赖指标与当前项目指标存在相同名称/标识。可修改相同的指标名称或标识后重试。

    • 时间周期：当前项目未配置匹配时间周期。如果在新环境或新项目未配置导入指标的时间周期，则指标导入失败。可在新环境或新项目中配置对应的时间周期后重试。

    • 指标域：指标域未创建。如果在当前环境或项目未创建相同的指标域，则指标导入失败，可前往「配置管理-指标目录」创建对应的指标域。

    • 来源指标系统指标不存在：当前项目不存在匹配的源于指标系统的指标。在当前环境中不存在来源于指标系统的指标，那么对应的根据指标系统创建的指标也会导入失败。可在当前环境指标系统中创建对应的指标。

    • 指标权限：无指标导入权限。有「新建原子/派生/计算指标」权限的用户默认有对应指标的资源导入权限，如有「新建原子指标」权限的用户可导入原子指标，如出现指标权限提示，可上报管理员申请指标权限。

  • 资源包：资源包解析错误。如果在资源包存在人为修改或删除情况，会导致资源包报错。可重试资源导出，再导入资源包，请勿修改资源包内容。

如您遇到了同样的问题，可按照说明对照处理。