Prometheus を使用して LindormTSDB に接続し、LindormTSDB をリモートストレージとして使用します。 - Lindorm

Lindorm 時系列エンジン (LindormTSDB) は、Prometheus のリモート書き込みおよびリモート読み取り機能用の API を提供します。これらの API を使用して LindormTSDB を Prometheus に接続し、LindormTSDB を Prometheus のリモートストレージとして指定できます。また、PromQL を使用して API を呼び出し、LindormTSDB のデータに効率的にアクセスすることもできます。

手順

データベースを作成します。データベースは、Prometheus のデータの保存とクエリに使用されます。次のステートメントは、データベースを作成する方法の例を示しています。データベースの作成に使用される構文の詳細については、「CREATE DATABASE」をご参照ください。
```
CREATE DATABASE my_promdb;
```
標準の Prometheus リモート書き込みプロトコルを使用して、データベースにデータを書き込みます。詳細については、「Prometheus 公式ドキュメント」をご参照ください。
次の例に示す形式で、Prometheus 関連のパラメーターを構成します。 db パラメーターには、手順 1 で作成したデータベースの名前を設定します。 HTTP 用の LindormTSDB エンドポイントを取得する方法の詳細については、「エンドポイントの表示」をご参照ください。
```
remote_write:
  - url: "<LindormTSDB endpoint for 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: "<LindormTSDB endpoint for HTTP>/api/v2/prom_read?db=db_name"
    basic_auth:
      username: <Username used to connect to LindormTSDB>
      password: <Password used to connect to LindormTSDB> 
```

Prometheus からデータベースに書き込まれたデータをクエリします。Prometheus のリモートデータ読み取り API または Lindorm の組み込み PromQL API を使用して、データをクエリできます。

Prometheus のリモートデータ読み取り API を使用してデータを読み取ります。
Lindorm データベースがセルフマネージド Prometheus サービスに接続されている場合は、次の例に示す形式で Prometheus の標準リモートデータ読み取り API を使用して、データベースからデータを読み取ることができます。HTTP 用の LindormTSDB エンドポイントを取得する方法の詳細については、「エンドポイントの表示」をご参照ください。
```
remote_read:
  - url: "<LindormTSDB endpoint for 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: "<LindormTSDB endpoint for HTTP>/api/v2/prom_read?db=db_name"
    basic_auth :
      username: <Username used to connect to LindormTSDB>
      password: <Password used to connect to LindormTSDB> 
```

Lindorm の組み込み PromQL API を使用してデータを読み取ります。

Lindorm は組み込みの PromQL API を提供しており、追加の Prometheus サービスをデプロイすることなく、PromQL を使用してデータをクエリできます。クエリのパフォーマンスは、Prometheus のリモートデータ読み取り API を使用する場合よりも高くなります。

たとえば、Grafana を使用してデータを監視する場合、Lindorm を Prometheus のデータソースとして指定できます。次の図は、Grafana で構成できるパラメーターを示しています。

パラメーター

説明

[URL]

HTTP 用の LindormTSDB エンドポイントを指定します。

[カスタムクエリパラメーター]

手順 1 で作成したデータベースを指定します。

例： db=my_promdb。

PromQL API を使用してデータをクエリする方法の詳細については、「Prometheus 公式ドキュメント」をご参照ください。 db パラメーターを、手順 1 で作成したデータベースの名前に設定します。次の URL は、PromQL API を使用してデータをクエリする方法の例を示しています。

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