指标管理
功能入口
左侧菜单监控告警 --> 指标管理
功能说明
- 查看平台预定义的采集指标
- 创建、修改、删除自定义SQL/SHELL采集数据库指标,平台通过Prometheus采集。
- 设置采集指标的保存时长
操作指南
采集指标列表
采集指标列表页面展示平台目前存在的各种数据库类型和主机的采集指标,页面左侧目录可以支持点击切换查看,名称后的数字代表对应类型下的采集指标数量;
指标来源字段可以区分采集指标是平台预定义还是用户自定义创建,预定义类型的指标,仅支持查看,不可编辑,删除和禁用;
自定义的指标支持禁用,修改和删除,上述操作均可能导致当前配置好的告警、监控等功能失效,请谨慎操作!
创建自定义指标
如果平台预定义的采集项不能满足需求,可以点击【创建】按钮,创建新的指标采集。
采集指标名称:支持输入中文,该指标在平台内的显示名称
指标英文名称:唯一标识指标采集,在Promethus采集项的命令规则为:数据库类型_custom_指标英文名称
指标分组:主机或者MogDB/openGauss
启用状态:开启代表创建完成后自动启用
采集脚本类型:支持SQL或者SHELL
值类型:
- 直接值,Prometheus gauges,可增可减的指标类型,监控及告警时计算直接获取的值;
- 累计值,Prometheus counters,只增不减的指标类型,除非发生重置,监控及告警时计算增量的差值;
采集频率:2次采集的间隔时间,默认2分钟;
采集维度:
- 数据库集群:按库采集,一个库只采集一次;
- 数据库实例:按实例采集,所有实例都会采集;
采集方案:支持针对不同的数据库版本,或者指定的数据库,使用不同的采集脚本,采集时将会自动选择匹配的采集方案进行数据采集。方案支持新增,删除和修改;
SQL语句:
- 采集的SQL语句。必须是select 语句;
- 文本不能超过10K;
- 字段只能以英文字母开头,可以包含数字和下划线,中划线,也是为了和prometheus的label标签一致;
- 最后一个字段必须为数字,因为最终采集数据是会由prometheus汇总展示的,最后一个字段作为prometheus的指标value,所以必须为数字;
- sql语句最多查询10个字段;
- 采集返回值不宜过多过大,影响性能;
- SQL语句结尾不要;号;
SHELL语句:
- 脚本返回结果必须为标准JSON格式,
- 结果中的字段名只能为英文字母、数字、下划线和中划线的组合,初始字符必须为英文字母;
- 结果中的字段最多不能超过10个;
- 最后一个字段将作为指标的值,所以必须为数字;
- 你可以通过引入变量获取当前数据库信息,不同数据库类型的变量请参考页面提示
输入语句后,点击“测试SQL语句”,测试采集SQL是否可正常运行,
需要在弹窗内选择一个测试用的数据库对象:
测试成功后会回显结果:
所有方案都需要测试通过后,才可以点击【确定】保存。
稍等一段时间(大约2-3分钟)后登陆平台Prometheus管理页面查看采集是否成功,地址:http://平台IP地址:8093
,输入自定义SQL指标采集的英文名称会自动模糊关联带出,点击“Execute”执行查询(在采集间隔时间内可能没有数据返回)。
点击“Graph”可查看历史采集值:
数据保存设置
可以设置平台的采集指标保存时长,默认为30天