Lindorm时序引擎提供remote write/remote read接口实现作为Prometheus的远端存储。同时原生支持PromQL访问接口以提供更加高效的数据访问。
操作步骤
创建数据库。用于存储和查询Prometheus数据,示例如下。具体语法请参考CREATE DATABASE。
CREATE DATABASE my_promdb;
数据写入,数据写入使用标准的Prometheus remote write协议,详情请参见Promethus官方文档。
配置Prometheus参数,通过参数db指定前面创建的数据库名称,配置URL语法如下。如何获取Lindorm 时序HTTP地址请参见查看连接地址。
remote_write: - url: "<Lindorm 时序HTTP地址>/api/v2/prom_write?db=db_name"
配置URL示例如下。
remote_write: - url: "http://ld-bp1q343mws8q9****-proxy-tsdb.lindorm.rds.aliyuncs.com:8242/api/v2/prom_write?db=my_promdb"
数据查询,写入Lindorm的Prometheus数据,可以通过Promethues远端读和内置PromQL查询接口两种方式进行查询,以下分别介绍。
Promethues远端读。
如果使用自建的Prometheus,可以使用标准的Prometheus远程读接口查询Lindorm,配置URL语法如下。如何获取Lindorm 时序HTTP地址请参见查看连接地址。
remote_read: - url: "<Lindorm 时序HTTP地址>/api/v2/prom_read?db=db_name"
配置URL示例如下。
remote_read: - url: "http://ld-bp1q343mws8q9****-proxy-tsdb.lindorm.rds.aliyuncs.com:8242/api/v2/prom_read?db=my_promdb"
内置PromQL接口查询。
Lindorm内置了PromQL的查询接口,不需要额外部署Prometheus服务,就可以直接通过PromQL查询数据,并且查询性能比remote read方式更高。
例如使用Grafana监控大盘,可以直接在Grafana上将Lindorm配置为Prometheus类型的数据源,如下图。
参数
说明
URL
配置Lindorm 时序HTTP地址。
Custom query parameters
配置创建的数据库。
示例:db=my_promdb。
PromQL查询API请参考Prometheus文档,通过参数db指定Lindorm的数据库即可,示例如下。
http://ld-bp1q343mws8q9****-proxy-tsdb.lindorm.rds.aliyuncs.com:8242/api/v1/query_range?db=my_promdb http://ld-bp1q343mws8q9****-proxy-tsdb.lindorm.rds.aliyuncs.com:8242/api/v1/query?db=my_promdb