更新时间:2023-05-22 13:34:27

指标模型管理模块支持指标模型的创建、删除、修改、查询及导入、导出等管理功能,具体说明请参考下文:

创建指标模型

通过定义指标及其计算规则可创建指标模型,配置项包括指标模型的名称、单位、维度、计算公式(计算公式编写当前仅支持PromQL等查询语言)等。您可根据实际需求,选择通过手动添加或批量导入的方式创建指标模型,具体如下:

手动创建指标模型

1. 配置指标模型

进入数据管理>数据模型>指标模型配置页面,如下所示:

点击【+新建】,进入“新建指标模型”的配置页面,如下所示:

相关配置参数说明请参考下表:

  配置参数 参数说明 限制条件
基本配置 *指标模型名称

填写指标模型的名称

• 指标模型名称不能重复,且不能为空;

• ≤40个字符

标签

根据实际需求设置指标模型的标签信息,用于业务标识,可通过键入回车键添加多个标签。

• 最多支持创建5个标签

备注 根据实际需求填写指标模型的其他属性信息

• ≤255个字符

模型配置 *指标类型

在下拉框中选择指标类型,默认类型为“原子指标”:

  • 原子指标:是对指标计算逻辑的基础定义,用于从根源上规范指标定义的一致性。

说明:当前仅支持配置原子指标

• 指标类型不能为空

*日志分组

点击【设置日志分组】,在页面右侧弹出的"选择日志分组"抽屉中选择指标数据的来源日志库所属的日志分组。

说明:

1. 如找不到需要的日志分组,可点击抽屉最下方的“新建日志分组”进行创建;

2. 当前仅支持选择日志分组中的根分组。

• 日志分组不能为空;

• 仅支持选择一个分组。

*查询语言

在下拉框中选择查询所需指标数据的对应查询语言。

说明:当前版本仅支持PromQL,后续将跟随版本迭代持续提供对其他查询语言此部分能力的支持,敬请期待!

• 查询语言不能为空

*计算公式

填写说明指标计算规则的查询语句,查询语句需遵循已配置的查询语言的语法规范。

指标模型生效后,系统会根据此处定义的计算规则,进行指标计算,得到具体的指标即"度量值"(详情请参见 指标模型数据项说明)。

说明:配置完成后,点击【数据预览】/【保存】后,系统将对计算公式语句的合法性进行校验,校验通过后,方可预览计算结果/成功创建指标模型。当前系统暂不对查询语句中的字段权限进行校验,若查询了日志分组中不存在的字段,数据查询结果则为空。

• 计算公式不能为空;

• 计算公式的书写语法需遵循PromQL的语法规则,具体规范请参见AnyRobot Eyes 5 UniQuery 开发者指南》2.3 PromQL 查询语言 2.3.1-2.3.4 章节了解PromQL查询语句的语法结构。若获取此文档失败,请联系相关一线技术支持人员获取。

*单位类型

在下拉框中设置输出指标(即“度量值”)的度量单位类型,您可根据指标需求自行定义,可选项包括:数值单位、存储单位、时间单位、传输速率。

-
*度量单位

根据实际业务场景的指标需求,在下拉框列表中设置指标模型输出指标的对应度量单位,不同单位类型对应可选择的度量单位具体如下:

  • 数值单位:无, 千, 百万, 十亿, 万亿,%
  • 存储单位:bit(s), Byte(s), KB, MB, GB, TB, PB
  • 时间单位:微秒,毫秒, 秒, 分, 时, 天, 周, 月, 年
  • 传输速率:bps, Kbps, Mbps
-

2. 预览指标模型数据

完成指标模型的各项参数的配置后,点击表单下方的【数据预览】,可在页面右侧弹出的抽屉中预览指标数据的实际计算结果,如下所示:

说明:预览抽屉中默认展示最近半小时的数据,步长为5分钟;

指标模型数据预览项说明:

参数 参数说明
维度

根据已配置的PromQL查询语句,在来源日志库中查询到的指标数据的lables字段值。

时间

根据已配置的PromQL查询语句,在来源日志库中查询到的指标数据的@timestamp字段值。

度量值

执行指标模型中已配置的计算公式后,得到的计算结果。

 批量导入创建指标模型

进入指标模型配置页面,点击列表上方的【导入】按钮,在弹出的窗口中选中包含指标模型配置信息的文件,点击【打开】后即可批量导入并创建指标模型。

注意:

1. 仅支持导入json格式的文件;

2. 支持导入多个指标模型:导入时,若指标模型的日志分组名称不存在,则导入操作失败。您需在完成对应日志分组的创建后,再进行导入操作;若AnyRobot中存有重名的指标模型对象,则导入动作将会停止,导入操作失败;

3. 批量导入失败后,您可在审计日志中查看对应的“失败”记录。

在指标模型列表中勾选某一指标模型后,点击列表上方的【导出】按钮,可将已创建的指标模型以“.json”格式导出,如下所示:

注意:支持导出多个指标模型。

► 其他管理操作

  查看/编辑/删除指标模型

指标模型配置页面,选中列表中需查看/修改/删除的指定模型后,点击列表操作列的“查看/编辑/删除”按钮后,系统可分别执行对应操作。

说明:

1. 支持删除已被系统其他模块引用的指标模型,删除后,引用该模型的其他分析模块将会报错提示;

2. 指标模型被删除后,您可在审计日志中查看相应的“删除”日志。