文档

通过Prometheus访问时序引擎

更新时间:

Lindorm时序引擎提供remote write/remote read接口实现作为Prometheus的远端存储。同时原生支持PromQL访问接口以提供更加高效的数据访问。

操作步骤

  1. 创建数据库。用于存储和查询Prometheus数据,示例如下。具体语法请参考CREATE DATABASE

    CREATE DATABASE my_promdb;
  2. 数据写入,数据写入使用标准的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"
  3. 数据查询,写入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类型的数据源,如下图。

      image

      参数

      说明

      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