Skip to content

指标中心(语义指标)

指标中心把「销售额」「活跃用户数」这类业务口径定义一次、处处复用:指标绑定数据集,声明聚合或公式、维度与显示格式,仪表盘与数据预警直接引用指标,避免同一口径在各处被重复(且不一致地)实现。在「报表中心 → 指标中心」(/report/metrics)管理。

指标类型

类型说明
简单指标对数据集某个字段做聚合:sum / avg / max / min / count / distinct_count
比率指标两个口径相除(如 转化率 = 下单数 / 访问数),用公式表达
复合指标由其它指标/字段组合的公式计算

新建指标

字段说明
指标名称 / 编码编码全局唯一,创建后不可修改
指标类型简单 / 比率 / 复合
数据集指标的取数来源
来源字段 / 聚合方式简单指标必填
公式比率/复合指标必填;只允许后端安全公式语法,服务端安全求值
维度字段允许按哪些字段分组下钻(逗号分隔)
时间字段用于按时间粒度(小时/天)聚合的列
单位 / 显示格式0,0.00
负责人 / 指标目录归属治理(见资源治理
统计口径 / 说明业务口径的文字定义,供使用方对齐

生命周期与发布快照

指标生命周期为 draft(草稿)→ published(已发布)→ deprecated(已废弃)

  • 编辑与生命周期操作携带 expectedRevision 乐观锁,并发冲突返回 409,需刷新后重试;
  • 发布」以当前修订固化发布快照,仪表盘、预警等运行端只消费发布快照——继续改草稿不影响引用方,直到再次发布;
  • 废弃」后引用方会看到生命周期警告,但不会阻断合法访问;
  • 草稿状态的指标可删除;废弃前应先检查「引用关系」。

评估与引用关系

  • 预览(评估):列表点「预览」→「执行计算」即时得到指标当前值(按显示格式与单位渲染),并显示耗时与是否命中缓存;计算由服务端安全执行,仅返回聚合结果,不下发原始查询。
  • 引用关系:查看该指标被哪些仪表盘组件、预警规则、派生指标引用,为变更与下线提供依据。

在其它模块中使用

  • 数据预警:预警规则的「来源类型」选指标即可直接监控指标值,无需重复配置聚合(见 AI 问数与数据预警)。
  • 仪表盘:组件可绑定指标获得统一口径的取数与格式化。

权限

操作权限码
查看 / 选项 / 引用关系report:metric:list
新增report:metric:create
编辑report:metric:update
删除(仅草稿)report:metric:delete
评估 / 预览report:metric:evaluate
发布 / 废弃report:metric:publish

Built with VitePress for local documentation preview.