Prometheus データソースへの接続 - Lindorm - Alibaba Cloud ドキュメントセンター

LindormTSDB は、リモートライト API とリモートリード API を提供し、Prometheus のリモートストレージバックエンドとして機能します。また、より効率的なメトリッククエリを実現する組み込み PromQL API も搭載しています。

手順

Prometheus メトリックを保存およびクエリするためのデータベースを作成します。構文の詳細については、「CREATE DATABASE」をご参照ください。
```
CREATE DATABASE my_promdb;
```
メトリックを書き込みます。標準の Prometheus リモートライトプロトコルを使用します。詳細については、「Prometheus のドキュメント」をご参照ください。

Prometheus のパラメーターを設定します。db パラメーターを使用して、作成したデータベースを指定します。LindormTSDB HTTP エンドポイントの取得方法については、「エンドポイントの確認」をご参照ください。
```
remote_write:
  - url: "<LindormTSDB HTTP エンドポイント>/api/v2/prom_write?db=db_name"
```
例：
```
remote_write:
  - url: "http://ld-bp1q343mws8q9****-proxy-tsdb.lindorm.rds.aliyuncs.com:8242/api/v2/prom_write?db=my_promdb"
```
LindormTSDB で認証が有効になっている場合は、設定に basic_auth セクションを含めてください。
```
remote_write:
  - url: "<LindormTSDB HTTP エンドポイント>/api/v2/prom_write?db=db_name"
    basic_auth:
      username: <LindormTSDB のユーザー名>
      password: <LindormTSDB のパスワード>
```

メトリックをクエリします。LindormTSDB に保存された Prometheus データをクエリするには、Prometheus リモートリードプロトコルを使用する方法と、組み込み PromQL API を使用する方法の 2 つがあります。

Prometheus リモートリード

セルフマネージド Prometheus インスタンスを使用している場合は、標準の Prometheus リモートリード API を使用して LindormTSDB をクエリできます。LindormTSDB HTTP エンドポイントの取得方法については、「エンドポイントの確認」をご参照ください。
```
remote_read:
  - url: "<LindormTSDB HTTP エンドポイント>/api/v2/prom_read?db=db_name"
```
例：
```
remote_read:
  - url: "http://ld-bp1q343mws8q9****-proxy-tsdb.lindorm.rds.aliyuncs.com:8242/api/v2/prom_read?db=my_promdb"
```
LindormTSDB で認証が有効になっている場合は、設定に basic_auth セクションを含めてください。
```
remote_read:
  - url: "<LindormTSDB HTTP エンドポイント>/api/v2/prom_read?db=db_name"
    basic_auth:
      username: <LindormTSDB のユーザー名>
      password: <LindormTSDB のパスワード>
```

組み込み PromQL API

LindormTSDB には組み込み PromQL API が搭載されています。Prometheus サービスをデプロイせずに、PromQL を使用して直接データをクエリできます。この方法は、リモートリード方式よりもクエリパフォーマンスが向上します。

例えば、Grafana モニタリングダッシュボードを使用する場合、Grafana で LindormTSDB を Prometheus タイプのデータソースとして直接設定できます。

Prometheus データソースを設定する際は、[Access] を [Server (default)]、[HTTP Method] を [POST]、[Query timeout] を 60 s、[Scrape interval] を 15 s に設定してください。

パラメーター

説明

URL

LindormTSDB HTTP エンドポイントを入力してください。

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

作成したデータベースを指定してください。

例： db=my_promdb。

PromQL クエリ API の詳細については、Prometheus のドキュメントをご参照ください。db パラメーターを使用して LindormTSDB のデータベースを指定します。

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