生成指标¶

即通过当前工作空间内的现有数据生成新的指标数据，从而根据实际业务需求设计并实现新的技术指标。

使用须知¶

仅拥有“生成指标配置管理权限”的角色可以创建和编辑指标；
指标生成后，将按照当前默认的数据存储策略进行存储，并根据生成的时间线数量进行收费；
若生成指标后未上报数据，则无法在工作空间中进行查询和分析。

能为您解决什么问题？¶

场景 1：从日志提取业务指标

业务日志中包含关键业务数据（如订单金额、错误码），需要转化为可监控的指标。通过生成指标，可选择日志数据源，配置查询条件筛选目标日志，提取字段生成指标（如错误日志数、平均响应时间），按业务维度分组（如服务、接口、状态码）。

场景 2：APM 数据聚合

基于 APM 链路数据生成服务 SLA 指标。选择 APM 数据源，按服务、接口分组统计，计算 P99 延迟、错误率、吞吐量等指标，定时生成，持续监控。

场景 3：资源使用统计

统计 Kubernetes 集群资源使用情况。选择基础对象或资源目录数据源，按集群、命名空间、节点分组，统计 Pod 数量、资源请求/限制等，生成资源利用率指标。

场景 4：多源数据融合

结合多个数据源生成复合指标。分别创建生成规则，基于生成的指标再次生成新指标，构建复杂的业务监控体系。

应用范围¶

日志、APM、RUM、指标、可用性监测、基础对象、资源目录。

开始新建¶

选择数据来源；
配置数据查询条件；
定义生成指标内容，对生成指标的方式和结果进行设置，包括生成指标的周期、新生成指标的标签名称和指标集名称。

数据查询¶

指标数据额外支持 PromQL 查询。除此之外，其他数据类型均支持简单查询和 DQL 查询。

更多详情，可参考图表查询。

聚合函数¶

函数	说明
`count`	统计个数
`avg`	统计平均值，需选择聚合的字段
`max`	统计最大值，需选择聚合的字段
`min`	统计最小值，需选择聚合的字段
`P75`	统计指定字段 75% 的值，需选择聚合的字段
`P95`	统计指定字段 95% 的值，需选择聚合的字段
`P99`	统计指定字段 99% 的值，需选择聚合的字段

维度¶

按照所选对象进行数据聚合，即对数据请求中的每一个所选对象都生成一个统计值。

生成指标内容¶

频率：生成指标的执行周期。频率所选时间也作为聚合时间，选择频率 1 分钟，即每隔 1 分钟聚合生成一次指标，每次聚合的时间范围也是 1 分钟；
- 1 分钟（默认，即每 1 分钟生成一次新的指标数据）
- 5 分钟（当数据类型为“基础对象”或“资源目录”时默认选中）
选择数据等待窗口，指定计算任务在任务窗口结束后的等待时长；
指标集：设置指标存放的指标集的名称；
指标：设置指标的名称，其中指标名称允许重复，可添加多个指标；
标签：根据查询中选择的维度自动生成；
单位：可选填，设置指标的单位，生成的指标设置单位后，即可在图表查询中应用；
描述：可选填，设置指标的描述，生成的指标设置描述后，即可在图表查询中应用。

完成填写后，点击确定即可完成生成指标规则并开启数据采集。

注意

若数据存在 1 分钟以上延迟情况时，则该数据落库后将不被统计。

数据等待窗口¶

任务窗口结束后，系统继续等待数据到达的时长。开启后可兼容数据上报延迟，提高指标准确性。

在生成指标时，系统会按照您设置的频率（如 1 分钟）定时执行查询。每次查询会检索一个固定的时间范围（即“任务窗口”）。但由于数据从产生到上报入库存在延迟，部分数据可能在任务窗口结束后才到达，导致这些“迟到”的数据无法被统计到。

开启数据等待窗口后，系统会在任务窗口结束后再等待一段时间，让延迟上报的数据有机会被纳入统计，从而提高指标准确性。

1. 以下场景建议开启数据等待窗口：

场景	问题描述	建议配置
接口执行时长较长	某接口执行 70 秒，span 的 `time` 为开始时间，但入库时已超过下一个任务窗口，导致永远统计不到	数据等待窗口 ≥ 接口最大执行时长
数据上报存在网络延迟	数据从客户端到服务端平均延迟 10~30 秒，查询最新时间的数据时统计不完整	1 分钟
批量上报或网络波动	部分数据集中上报或网络不稳定，延迟可达数分钟	5 分钟或 15 分钟

2. 计算逻辑示例（频率 1 分钟，数据等待窗口 1 分钟）：

任务执行时间：13:01:00
任务窗口（实际查询的 time 范围）：13:00:00 ~ 13:01:00
数据等待窗口：1 分钟
实际查询执行时间：13:02:00（等待 1 分钟后）

即：系统在 13:02:00 执行查询，检索 time 在 13:00:00 ~ 13:01:00 的数据。此时即使部分数据在 13:01:00 之后才入库，只要其 time 属于 13:00:00 ~ 13:01:00，就能被统计到。

管理列表¶

编辑：可查看全部已创建的生成指标规则，并对生成指标规则进行编辑。
启用/禁用：即修改规则的状态。指标生成规则被禁用后，对应的数据将不会写入指标集，待启用后恢复写入。
删除：即删除不需要的规则。规则被删除后，指标集不会被删除，但会停止数据写入。
批量操作：可针对特定规则进行批量操作，包括启用、禁用、删除和导出规则。
导入：即导入生成指标数据。
查看指标
- 在指标分析中查看：即跳转至指标分析页面进行查询和分析。
- 在指标管理中查看：即跳转至指标管理页面查看指标和标签，您可以编辑指标单位和描述。

注意

由于生成指标规则的数据来源、聚合表达式等决定了数据类型，部分配置不支持编辑和修改；
生成的指标是基于您选择的频率和查询时间范围内的数据聚合生成的。如果在该时间段内无数据上报，则无法生成指标，也无法在指标中查询或搜索。

应用场景¶

图表查询¶

在可视化图表中进行指标数据查询和分析。

查询工具¶

在快捷入口 > 查询工具 > DQL 查询 中进行指标数据查询和分析。