创建指标模型

填写指标模型的名称

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

• ≤40个字符

选填项。选择指标模型所属的分组信息，若此指标模型未指定分组，则自动分组至"默认分组"下。

-

必填项。当指标模型配置持久化任务后，此字段将作为指标持久化后存储的字段。

• 度量名称全局唯一不能重复，且不能为空；

• 度量名称必须以特殊字符（__m.）开头，此前缀不允许被修改；

• 度量名称的自定义部分只允许以字母、数字开头，且只允许包含字母、数字、下划线，不允许使用英文句号

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

• 最多支持创建5个标签

• ≤255个字符

提示：10000为默认参数，您可以直接应用此参数，也可以根据实际场景自定义。

嵌套的date_histogram聚合查询部分。表示将在terms聚合的每个分组中进行的date_histogram聚合。

date_histogram（日期直方图）聚合结果的名称，用于标识聚合操作的结果，您可根据需求自定义命名。

date_histogram（日期直方图）聚合部分。分桶聚合类型，用于根据指定日期字段的值对数据进行分组，并统计指定的时间间隔内的文档数量或计算其他度量指标。

date_histogram（日期直方图）聚合的分组字段。您可根据实际需求自定义分组所需的日期字段，书写格式可参见OpenSearch官网文档>AGGREGATIONS>Date histogram aggregation 的相关内容。

date_histogram分桶聚合下，支持使用fixed_interval（固定时间间隔）以及calendar_interval（日历感知时间间隔）定义时间分桶的间隔。

fixed_interval表示按照指定的固定时间间隔对数据集进行分组。fixed_interval指定了一个固定的时间间隔（例如，秒、分钟、小时等）进行分组，无论查询的时间段长度如何，间隔都保持不变。fixed_interval通常用于创建均匀的时间间隔，适用于时间序列分析场景。配置限制说明如下：

需注意，在date_histogram聚合方式中fixed_interval若需设置为变量，格式应填写为{{__interval}}，表示聚合将根据其它已指定的固定时间间隔执行分组。

date_histogram分桶聚合下，支持使用fixed_interval（固定时间间隔）以及calendar_interval（日历感知时间间隔）定义时间分桶的间隔。

calendar_interval表示按照感知日历的时间间隔对数据集进行分组。calendar_interval根据实际日历单位（例如，年、月、周等）进行分组，将根据每个时间段的实际日历单位来确定具体的间隔大小。能够根据实际日历，灵活创建适于月末、年末等特殊日历情况的连续时间间隔。配置限制说明如下：

• 当选择按照日历感知时间间隔进行分桶时，不支持配置为变量，当前支持的日历间隔如下：

"calendar_interval": "1m"或"calendar_interval": "minute"

"calendar_interval": "1h"或"calendar_interval": "hour"

"calendar_interval": "1d"或"calendar_interval": "day"

"calendar_interval": "1w"或"calendar_interval": "week"

"calendar_interval": "1M"或"calendar_interval": "month"

"calendar_interval": "1q"或"calendar_interval": "quarter"

• 当选择按照日历感知时间间隔进行分桶时，可指定时区（默认为Asia/Shanghai时区）。其参数只接受例如Asia/Shanghai的字符串格式，暂不支持其它格式，具体如下：

"time_zone": "Asia/Shanghai"

表示将对分组结果进行排序。

分组结果的具体排序方式。如"_key":"asc"表示将对分组结果进行升序排列。

填写持久化任务名称。此名称将会作为维度字段（labels.task_name）写入到持久化的指标数据中。

• 名称不能重复，且不能为空；

• ≤40个字符

根据实际需求填写持久化任务的其他属性信息。

• ≤255个字符

设置指标数据持久化时，生成指标数据点的时间间隔。当查询语言为PromQL，此参数也决定了指标模型查询指标数据的时间范围。例如，当持久化步长配置为5分钟时，则每隔5分钟，指标模型将查询当前时间点前5分钟的指标数据，计算生成指标数据点，并存入持久化数据。

特殊情况说明，查询语言为PromQL时，若计算公式中使用了 irate() 函数，持久化步长与数据查询的时间范围参数有如下情况：

• 若计算公式中的range参数设置为auto，则持久化任务查询指标数据时，持久化步长参数也决定了查询指标数据的时间范围；
• 若计算公式中的range参数设置为常量，则持久化任务查询指标数据时，查询指标数据的时间范围由此常量决定。

点击文本配置框，填写持久化步长，并选择其时间单位，可选单位：分钟、小时、天。

说明：持久化步长参数会作为维度字段（labels.step）写入到持久化的指标数据中，在使用当前持久化的数据继续创建指标模型时，需添加“step={{*持久化步长}}”的过滤条件。

• 持久化步长不能为空，且只能配置一个持久化步长；

• 在文本框中配置具体步长时，需输入正整数数字

追溯时长是指从当前时间向过去回退的时间长度，用于确定持久化数据的起始时间点。例如，追溯时长配置为“2天”，系统会从当前时间回退2天的时间点开始，并按照持久化任务配置信息，逐个步长计算历史数据点，进行数据持久化。即系统会根据持久化任务的配置信息补充前面2天的持久化数据点。

点击文本配置框，填写或点击“”按钮设置追溯时长，并选择其时间单位，可选单位：小时、天。

注意：完成指标模型的配置后，不支持修改此配置项。

• 追溯时长需为正整数；

• 追溯时长最小单位为小时，追溯时长上限为30天

设置系统执行此持久化任务的时间间隔，即持久化任务的运行频率。例如：当执行频率设置为“每5分钟”，则此持久化任务每5分钟执行一次。

点击文本配置框，填写或点击“”按钮配置具体时间间隔，并选择其时间单位，可选单位：分钟、小时、天。

• 执行频率不能为空，且必须为正整数数字

根据持久化数据需求，设置过滤条件，筛选符合特定条件的数据进行持久化。

提示：此项为选填项。选择性地持久化存储符合特定条件的数据，能够帮助优化存储、提高查询效率。

-

• 索引库不能为空

填写持久化任务名称。此名称将会作为维度字段（labels.task_name）写入到持久化的指标数据中。

• 名称不能重复，且不能为空；

• ≤40个字符

根据实际需求填写持久化任务的其他属性信息。

• ≤255个字符

设置指标模型查询指标数据的时间范围，用于获取指定时间段内的指标数据，进行持久化。仅当查询语言为DSL时，此参数可配置。

点击【添加时间窗口】，在时间窗口输入框中填写正整数，选择时间窗口的时间单位，可选单位：分钟、小时、天。

说明：时间窗口会作为维度字段（labels.time_window）写入到持久化的指标数据中。在在使用当前持久化的数据继续创建指标模型时，需添加“time_window={{*时间窗口}}”的过滤条件。

• 当查询语言配置为DSL时，支持配置此参数；

• 同一任务中，时间窗口不能重复；

• 时间窗口不能为空；

• 配置自定义时间时，需输入正整数数字

设置进行指标数据持久化时生成数据点的时间间隔。例如，当持久化步长配置为5分钟，则每隔5分钟，指标模型将查询当前时间点前5分钟（时间范围由上方*时间窗口参数决定）的指标数据，计算生成指标数据点，并存入持久化数据。

特殊情况说明，查询语言为DSL时，若计算公式中使用了date_histogram聚合方式，持久化步长与数据查询的时间范围参数有如下情况：

• 若计算公式中date_histogram使用了fixed_interval：
  • 若使用了变量{{_interval}}，则持久化任务查询指标数据时，持久化任务配置的时间窗口参数决定了指标数据查询时的具体时间范围；
  • 若使用了常量，则持久化任务查询指标数据时，查询指标数据的时间范围由此常量决定。
• 若计算公式中date_histogram使用了calendar_interval，则持久化任务查询指标数据时，查询指标数据的时间范围由此参数决定。

点击文本配置框，填写持久化步长，并选择其时间单位，可选单位：分钟、小时、天。

说明：持久化步长参数会作为维度字段（labels.step）写入到持久化的指标数据中。在使用当前持久化的数据继续创建指标模型时，需添加“step={{*持久化步长}}”的过滤条件。

• 持久化步长不能为空，且只能配置一个持久化步长；

• 在文本框中配置具体步长时，需输入正整数数字

根据实际需求，设置持久化数据的历史时间范围。即指标模型在查询需要持久化存储的指标数据时，可以回溯的时间范围。完成配置后，此持久化任务将查询过去此时间范围内的指标数据，并进行持久化。

点击文本配置框，填写或点击“”按钮设置追溯时长，并选择其时间单位，可选单位：小时、天。

注意：完成指标模型的配置后，不支持修改此配置项。

• 追溯时长需为正整数；

• 追溯时长最小单位为小时，追溯时长上限为30天

设置系统执行此持久化任务的时间间隔，即持久化任务的运行频率。例如：当执行频率设置为“每5分钟”，则每隔5分钟，系统将会对此模型查询到的指标数据执行一次数据持久化。

点击文本配置框，填写或点击“”按钮配置具体时间间隔，并选择其时间单位，可选单位：分钟、小时、天。

• 执行频率不能为空，且必须为正整数数字

根据持久化数据需求，设置过滤条件，筛选符合特定条件的数据进行持久化。

提示：此项为选填项。选择性地持久化存储符合特定条件的数据，能够帮助优化存储、提高查询效率。

-

• 索引库不能为空