對接源端儲存Prometheus - Lindorm

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時序引擎開啟鑒權配置時，配置URL樣本如下。

remote_write:
  - url: "<Lindorm 時序HTTP地址>/api/v2/prom_read?db=db_name"
    basic_auth:
      username: <時序引擎的使用者名稱>
      password: <時序引擎的密碼>

資料查詢，寫入Lindorm的Prometheus資料，可以通過Promethues遠端讀和內建PromQL查詢介面兩種方式進行查詢，以下分別介紹。
- Prometheus遠端讀。
  如果使用自建的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"
```
  Lindorm時序引擎開啟鑒權配置時，配置URL樣本如下。
```
remote_read:
  - url: "<Lindorm 時序HTTP地址>/api/v2/prom_read?db=db_name"
    basic_auth :
      username : <時序引擎的使用者名稱>
      password : <時序引擎的密碼>
```
- 內建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
```