指标模型管理

填写指标模型的名称

• 指标模型名称不能重复，且不能为空；

• ≤40个字符

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

• 最多支持创建5个标签

• ≤255个字符

在下拉框中选择指标的类型，指标类型默认为“原子指标”：

• 原子指标：是对指标计算逻辑、具体算法的第一层抽象，可从根源上规范指标定义，保证指标的一致性。

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

• 指标类型不能为空

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

说明：

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

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

• 日志分组不能为空；

• 仅支持选择一个分组。

根据数据源的数据类别（category）选择获取所需指标数据的对应查询语言，可选项：PromQL、DSL，具体如下：

• 当数据类别（category）为指标数据（Metric）时，请根据使用偏好自行选择查询语言（“PromQL”（推荐）或“DSL”）创建指标模型。提示：推荐选择“PromQL”，配置操作较为简易；

• 当数据类别（category）为链路数据（Trace）/日志数据（Log）/事件数据（Event）时，需选择“DSL”创建对应数据类型的指标模型。

• 查询语言不能为空

当*查询语言选择“PromQL”时，需在此配置框中填写说明指标计算规则的PromQL查询语句（关于具体语法规则的说明，请参见右侧限制条件）。

指标模型生效后，系统会根据此处定义的计算规则，进行指标计算并得到指标数据（关于指标计算结果的详细说明，请参见 预览指标数据）。

说明：

1. 配置完成后，点击【数据预览】/【保存】后，系统将对计算公式语句的合法性进行校验，校验通过后，方可预览计算结果/成功创建指标模型。

2. 当前系统暂不对查询语句中的字段权限进行校验，若查询了日志分组中不存在的字段，数据查询结果则为空。

• 计算公式不能为空；

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

当*查询语言选择“DSL”时，此配置框中默认提供了公式的预输入框架，您需根据实际指标需求自行配置用于说明指标聚合方式、聚合规则的DSL查询语句。查询语句需遵循DSL的语法规范及其他约束条件，关于具体约束条件的说明，请参见右侧限制条件。

指标模型生效后，系统会根据此处定义的计算规则，进行指标计算并得到指标数据（关于指标计算结果的详细说明，请参见 预览指标数据）。

说明：

1. 配置完成后，点击【数据预览】/【保存】后，系统将对计算公式语句的合法性进行校验，校验通过后，方可预览计算结果/成功创建指标模型。

2. 当前系统暂不对查询语句中的字段权限进行校验，若查询了日志分组中不存在的字段，数据查询结果则为空。

• 计算公式不能为空；

• 计算公式的书写需遵循DSL的基本语法规则及其他约束条件。关于DSL语法结构，请参见OpenSearch官网中DSL相关文档。其他约束条件具体如下：

1. 特定参数约束：

• DSL语句中的 size 需设置为 0

2. 聚合方式及层数约束：

• 当前不支持并行聚合（Multiple aggregation）查询；
• 当前支持的聚合方式如下：
  • 分桶聚合：date_histogram（日期直方图）、terms（词条）、filters（过滤）、range（范围）、date_range（日期范围）
  • 值聚合： value_count（计数）、cardinality（去重计数） 、sum（求和）、avg（均值）、max（最大值）、min（最小值）、top_hits（桶内排序取 Top N）
• 支持配置的分桶聚合层数需≤7，值聚合层数需＝1，各层聚合的聚合名称不能重复。

3. 子聚合约束：

• date_histogram（日期直方图）
  • 计算公式中必须包含date_histogram，且只能有一个；
  • date_histogram 分桶聚合下的子聚合需是一个值聚合类型；
  • date_histogram 聚合方式中的 fixed_interval 参数需设置为变量，格式为 {{__interval}}，表示 fixed_interval 将随分析动态调整时间分桶的间隔。
• top_hits（桶内排序取 Top N）
  • top_hits 需满足如下结构：

"size": <number>,
"sort": [
    {
        "<sort_field_name>": {
            "order": "desc | asc"
        }
    }
],
"_source": {
    "includes": [
        "<field_name1>",
        "<field_name2>",
        ......
    ]
}

仅当*查询语言选择“DSL”时，此项可配置且为必选项，配置说明如下：

• 当计算公式中的值聚合方式为top_hits时，此处配置的度量字段应为top_hits中_source所包含的字段名称，且此字段名称对应的字段类型应为数值字段，不兼容日期。
• 当计算公式中的值聚合方式为其他类型时，此处配置的度量字段应为计算公式（即DSL查询语句）中的值聚合名称，若配置的度量字段与值聚合名称不匹配，系统将会报错。

• 度量字段不能为空

根据实际指标需求设置输出指标（即“度量值”）的度量单位类型，可选项包括：数值单位、存储单位、时间单位、传输速率。

根据实际指标需求设置输出指标（即“度量值”）的度量单位，不同单位类型下可选择的具体度量单位如下：

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

必选项。设置筛选的类型，可选项：范围查询、即时查询。

必选项。设置筛选的时间范围或时间点，具体如下：

• 当查询类型选择“范围查询”时，需配置具体的“时间范围”，默认为“最近30分钟”。筛选成功生效后，预览抽屉下方的<指标趋势图>、<指标数据预览表>区域将只展示匹配此时间范围的数据预览结果。
• 当查询类型选择“即时查询”时，需配置具体的“时间”点，默认为当前日期及当前时刻。筛选成功生效后，预览抽屉下方的<指标数据预览表>区域将展示此时间点的数据预览结果。

提示：选择“即时查询”后，仅可查看指定时间点的<指标数据预览表>。

选填项。设置筛选的维度（lables字段值）及维度值，如设置的筛选维度为“cpu”、维度值为“1”，下方的<指标趋势图>、<指标数据预览表>区域将展示维度包含“cpu=1”的统计结果。点击“+添加筛选条件”可添加多个维度条件。

仅当选择【范围查询】时，可查看此趋势图。<指标趋势图>以时间为横轴，以度量值（度量值单位为系统自动转换的单位）为纵轴，展示了符合筛选条件的指标在指定时间范围内的趋势。通过预览指标趋势，您可根据实际指标需求及时调整指标模型的相关参数。

<指标数据预览表>展示了指定时间周期/时间点内符合筛选条件的指标数据，具体如下：

• 维度：即指标模型执行计算公式（即查询语句）后，在来源日志库中查询到的指标数据的lables字段值。
• 时间：即指标模型执行计算公式（即查询语句）后，在来源日志库中查询到的指标数据的@timestamp字段值。
• 度量值：即指标模型执行计算公式（即查询语句）后得到的计算结果。为便于展示且方便用户查看，在预览时，此度量值的单位为系统自动转换的单位。